Public 멤버 함수
CardProfile	ImportVCard (string content, CardProfile template)

정적 Private 멤버 함수
static Dictionary< string, List< string > >	ReadVCardValues (string content)
static List< string >	UnfoldLines (string content)
static string	DecodeValue (string keyPart, string rawValue)
static string	DecodePhoto (string keyPart, string rawValue)
static Encoding	GetCharset (string keyPart)
static string	DecodeQuotedPrintable (string value, Encoding encoding)
static bool	IsHex (char value)
static string	UnescapeVCard (string value)
static string	ParseName (string value)
static string	ParseAddress (string value)
static string	First (Dictionary< string, List< string > > values, string key)
static string	Join (Dictionary< string, List< string > > values, string key)
static string	Coalesce (params string?[] values)

상세한 설명

Card Profile Importer 기능과 관련 상태를 캡슐화합니다.

CardProfileImporter.cs 파일의 14 번째 라인에서 정의되었습니다.

멤버 함수 문서화

◆ Coalesce()

string Codemaru.Services.CardProfileImporter.Coalesce ( params string?[] values )

inlinestaticprivate

Coalesce 작업을 수행합니다.

매개변수

values values에 사용할 string?[] 값입니다.

반환값: Coalesce 작업에서 생성한 string 결과입니다.

CardProfileImporter.cs 파일의 641 번째 라인에서 정의되었습니다.

    {
        return values.FirstOrDefault(static value => !string.IsNullOrWhiteSpace(value))?.Trim() ?? string.Empty;
    }

다음에 의해서 참조됨 : ImportVCard().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ DecodePhoto()

string Codemaru.Services.CardProfileImporter.DecodePhoto	(	string	keyPart,
		string	rawValue )

inlinestaticprivate

Decode Photo 작업을 수행합니다.

매개변수

keyPart	key Part에 사용할 `string` 값입니다.
rawValue	raw Value에 사용할 `string` 값입니다.

반환값: Decode Photo 작업에서 생성한 string 결과입니다.

CardProfileImporter.cs 파일의 279 번째 라인에서 정의되었습니다.

    {
        if (rawValue.StartsWith("data:", StringComparison.OrdinalIgnoreCase))
        {
            return rawValue.Trim();
        }
 
        var base64 = new string(rawValue.Where(static c => !char.IsWhiteSpace(c)).ToArray());
        if (base64.Length == 0)
        {
            return string.Empty;
        }
 
        var type = "png";
        if (keyPart.Contains("JPEG", StringComparison.OrdinalIgnoreCase) ||
            keyPart.Contains("JPG", StringComparison.OrdinalIgnoreCase))
        {
            type = "jpeg";
        }
        else if (keyPart.Contains("SVG", StringComparison.OrdinalIgnoreCase))
        {
            type = "svg+xml";
        }
        else if (keyPart.Contains("WEBP", StringComparison.OrdinalIgnoreCase))
        {
            type = "webp";
        }
 
        return $"data:image/{type};base64,{base64}";
    }

다음에 의해서 참조됨 : ReadVCardValues().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ DecodeQuotedPrintable()

string Codemaru.Services.CardProfileImporter.DecodeQuotedPrintable	(	string	value,
		Encoding	encoding )

inlinestaticprivate

Decode Quoted Printable 작업을 수행합니다.

매개변수

value	적용할 값입니다.
encoding	encoding에 사용할 `Encoding` 값입니다.

반환값: Decode Quoted Printable 작업에서 생성한 string 결과입니다.

CardProfileImporter.cs 파일의 387 번째 라인에서 정의되었습니다.

    {
        var bytes = new List<byte>();
        for (var i = 0; i < value.Length; i++)
        {
            if (value[i] == '=' && i + 2 < value.Length &&
                IsHex(value[i + 1]) && IsHex(value[i + 2]))
            {
                bytes.Add(Convert.ToByte(value.Substring(i + 1, 2), 16));
                i += 2;
            }
            else
            {
                bytes.Add((byte)value[i]);
            }
        }
 
        return encoding.GetString(bytes.ToArray());
    }

다음을 참조함 : IsHex().

다음에 의해서 참조됨 : DecodeValue().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ DecodeValue()

string Codemaru.Services.CardProfileImporter.DecodeValue	(	string	keyPart,
		string	rawValue )

inlinestaticprivate

Decode Value 작업을 수행합니다.

매개변수

keyPart	key Part에 사용할 `string` 값입니다.
rawValue	raw Value에 사용할 `string` 값입니다.

반환값: Decode Value 작업에서 생성한 string 결과입니다.

CardProfileImporter.cs 파일의 236 번째 라인에서 정의되었습니다.

    {
        var value = rawValue;
        if (keyPart.Contains("ENCODING=QUOTED-PRINTABLE", StringComparison.OrdinalIgnoreCase))
        {
            value = DecodeQuotedPrintable(rawValue, GetCharset(keyPart));
        }
 
        return UnescapeVCard(value).Trim();
    }

다음을 참조함 : DecodeQuotedPrintable(), GetCharset(), UnescapeVCard().

다음에 의해서 참조됨 : ReadVCardValues().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ First()

string Codemaru.Services.CardProfileImporter.First	(	Dictionary< string, List< string > >	values,
		string	key )

inlinestaticprivate

First 작업을 수행합니다.

매개변수

values	values에 사용할 `Dictionary<string, List<string>>` 값입니다.
key	key에 사용할 `string` 값입니다.

반환값: First 작업에서 생성한 string 결과입니다.

CardProfileImporter.cs 파일의 573 번째 라인에서 정의되었습니다.

    {
        return values.TryGetValue(key, out var list) ? list.FirstOrDefault() ?? string.Empty : string.Empty;
    }

다음에 의해서 참조됨 : ImportVCard().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ GetCharset()

Encoding Codemaru.Services.CardProfileImporter.GetCharset ( string keyPart )

inlinestaticprivate

Charset 값을 가져옵니다.

매개변수

keyPart key Part에 사용할 string 값입니다.

반환값: Get Charset 작업에서 생성한 Encoding 결과입니다.

CardProfileImporter.cs 파일의 334 번째 라인에서 정의되었습니다.

    {
        var parts = keyPart.Split(';', StringSplitOptions.RemoveEmptyEntries | StringSplitOptions.TrimEntries);
        var charsetPart = parts.FirstOrDefault(part => part.StartsWith("CHARSET=", StringComparison.OrdinalIgnoreCase));
        var charset = charsetPart?.Split('=', 2)[1].Trim('"');
        if (string.IsNullOrWhiteSpace(charset))
        {
            return Encoding.UTF8;
        }
 
        try
        {
            Encoding.RegisterProvider(CodePagesEncodingProvider.Instance);
            return Encoding.GetEncoding(charset);
        }
        catch
        {
            return Encoding.UTF8;
        }
    }

다음에 의해서 참조됨 : DecodeValue().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ ImportVCard()

CardProfile Codemaru.Services.CardProfileImporter.ImportVCard	(	string	content,
		CardProfile	template )

inline

Import V Card 작업을 수행합니다.

매개변수

content	content에 사용할 `string` 값입니다.
template	template에 사용할 `CardProfile` 값입니다.

반환값: Import V Card 작업에서 생성한 CardProfile 결과입니다.

CardProfileImporter.cs 파일의 48 번째 라인에서 정의되었습니다.

    {
        var values = ReadVCardValues(content);
        var name = First(values, "FN");
        if (string.IsNullOrWhiteSpace(name))
        {
            name = ParseName(First(values, "N"));
        }
 
        var company = First(values, "ORG");
        var title = First(values, "TITLE");
        var email = Join(values, "EMAIL");
        var phone = Join(values, "TEL");
        var address = ParseAddress(First(values, "ADR"));
        var url = First(values, "URL");
        var note = First(values, "NOTE");
        var photo = First(values, "PHOTO");
        var brand = Coalesce(company, template.BackBrand, template.Brand);
 
        return template with
        {
            Brand = brand,
            BackBrand = brand,
            Tagline = string.IsNullOrWhiteSpace(title) ? template.Tagline : title,
            BackTagline = string.IsNullOrWhiteSpace(company) ? template.BackTagline : company,
            Name = Coalesce(name, template.Name),
            Role = Coalesce(title, template.Role),
            Email = Coalesce(email, template.Email),
            Phone = Coalesce(phone, template.Phone),
            Address = Coalesce(address, template.Address),
            Website = Coalesce(url, template.Website),
            ShortBio = Coalesce(note, template.ShortBio),
            LandingDescription = Coalesce(note, template.LandingDescription),
            VCardNote = Coalesce(note, template.VCardNote),
            LogoImageDataUrl = string.IsNullOrWhiteSpace(photo) ? template.LogoImageDataUrl : photo,
            ImportedFrontImageDataUrl = null,
            ImportedBackImageDataUrl = null,
            IncludePhoneInVCard = !string.IsNullOrWhiteSpace(phone) || template.IncludePhoneInVCard,
            IncludeAddressInVCard = !string.IsNullOrWhiteSpace(address) || template.IncludeAddressInVCard
        };
    }

다음을 참조함 : Codemaru.Models.CardProfile(), Coalesce(), First(), Join(), ParseAddress(), ParseName(), ReadVCardValues().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

◆ IsHex()

bool Codemaru.Services.CardProfileImporter.IsHex ( char value )

inlinestaticprivate

Is Hex 조건을 확인합니다.

매개변수

value 적용할 값입니다.

반환값: Is Hex 조건이 충족되면 true이고, 그렇지 않으면 false입니다.

CardProfileImporter.cs 파일의 431 번째 라인에서 정의되었습니다.

    {
        return (value >= '0' && value <= '9') ||
            (value >= 'A' && value <= 'F') ||
            (value >= 'a' && value <= 'f');
    }

다음에 의해서 참조됨 : DecodeQuotedPrintable().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ Join()

string Codemaru.Services.CardProfileImporter.Join	(	Dictionary< string, List< string > >	values,
		string	key )

inlinestaticprivate

Join 작업을 수행합니다.

매개변수

values	values에 사용할 `Dictionary<string, List<string>>` 값입니다.
key	key에 사용할 `string` 값입니다.

반환값: Join 작업에서 생성한 string 결과입니다.

CardProfileImporter.cs 파일의 610 번째 라인에서 정의되었습니다.

    {
        return values.TryGetValue(key, out var list)
            ? string.Join(Environment.NewLine, list.Where(static value => !string.IsNullOrWhiteSpace(value)))
            : string.Empty;
    }

다음에 의해서 참조됨 : ImportVCard().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ ParseAddress()

string Codemaru.Services.CardProfileImporter.ParseAddress ( string value )

inlinestaticprivate

Parse Address 작업을 수행합니다.

매개변수

value 적용할 값입니다.

반환값: Parse Address 작업에서 생성한 string 결과입니다.

CardProfileImporter.cs 파일의 530 번째 라인에서 정의되었습니다.

    {
        if (string.IsNullOrWhiteSpace(value))
        {
            return string.Empty;
        }
 
        var parts = value.Split(';');
        return string.Join(" ", parts.Skip(2).Where(static part => !string.IsNullOrWhiteSpace(part))).Trim();
    }

다음에 의해서 참조됨 : ImportVCard().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ ParseName()

string Codemaru.Services.CardProfileImporter.ParseName ( string value )

inlinestaticprivate

Parse Name 작업을 수행합니다.

매개변수

value 적용할 값입니다.

반환값: Parse Name 작업에서 생성한 string 결과입니다.

CardProfileImporter.cs 파일의 495 번째 라인에서 정의되었습니다.

    {
        if (string.IsNullOrWhiteSpace(value))
        {
            return string.Empty;
        }
 
        var parts = value.Split(';');
        return string.Join(" ", parts.Take(2).Reverse().Where(static part => !string.IsNullOrWhiteSpace(part))).Trim();
    }

다음에 의해서 참조됨 : ImportVCard().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ ReadVCardValues()

Dictionary< string, List< string > > Codemaru.Services.CardProfileImporter.ReadVCardValues ( string content )

inlinestaticprivate

V Card Values 데이터를 읽습니다.

매개변수

content content에 사용할 string 값입니다.

반환값: Read V Card Values 작업에서 생성한 Dictionary<string, List<string>> 결과입니다.

CardProfileImporter.cs 파일의 114 번째 라인에서 정의되었습니다.

    {
        var values = new Dictionary<string, List<string>>(StringComparer.OrdinalIgnoreCase);
        var lines = UnfoldLines(content);
 
        foreach (var line in lines)
        {
            var colon = line.IndexOf(':', StringComparison.Ordinal);
            if (colon <= 0)
            {
                continue;
            }
 
            var keyPart = line[..colon];
            var rawValue = line[(colon + 1)..];
            var key = keyPart.Split(';', 2)[0].Trim();
            if (string.IsNullOrWhiteSpace(key))
            {
                continue;
            }
 
            var value = DecodeValue(keyPart, rawValue);
            if (key.Equals("PHOTO", StringComparison.OrdinalIgnoreCase))
            {
                value = DecodePhoto(keyPart, rawValue);
            }
 
            if (string.IsNullOrWhiteSpace(value))
            {
                continue;
            }
 
            if (!values.TryGetValue(key, out var list))
            {
                list = new List<string>();
                values[key] = list;
            }
 
            list.Add(value);
        }
 
        return values;
    }

다음을 참조함 : DecodePhoto(), DecodeValue(), UnfoldLines().

다음에 의해서 참조됨 : ImportVCard().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ UnescapeVCard()

string Codemaru.Services.CardProfileImporter.UnescapeVCard ( string value )

inlinestaticprivate

Unescape V Card 작업을 수행합니다.

매개변수

value 적용할 값입니다.

반환값: Unescape V Card 작업에서 생성한 string 결과입니다.

CardProfileImporter.cs 파일의 462 번째 라인에서 정의되었습니다.

    {
        return value
            .Replace("\\n", Environment.NewLine, StringComparison.OrdinalIgnoreCase)
            .Replace("\\;", ";", StringComparison.Ordinal)
            .Replace("\\,", ",", StringComparison.Ordinal)
            .Replace("\\\\", "\\", StringComparison.Ordinal);
    }

다음에 의해서 참조됨 : DecodeValue().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ UnfoldLines()

List< string > Codemaru.Services.CardProfileImporter.UnfoldLines ( string content )

inlinestaticprivate

Unfold Lines 작업을 수행합니다.

매개변수

content content에 사용할 string 값입니다.

반환값: Unfold Lines 작업에서 생성한 List<string> 결과입니다.

CardProfileImporter.cs 파일의 182 번째 라인에서 정의되었습니다.

    {
        var normalized = content
            .Replace("\r\n", "\n", StringComparison.Ordinal)
            .Replace('\r', '\n');
        var lines = new List<string>();
 
        foreach (var line in normalized.Split('\n'))
        {
            if ((line.StartsWith(' ') || line.StartsWith('\t')) && lines.Count > 0)
            {
                lines[^1] += line[1..];
            }
            else
            {
                lines.Add(line);
            }
        }
 
        return lines;
    }

다음에 의해서 참조됨 : ReadVCardValues().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

이 클래스에 대한 문서화 페이지는 다음의 파일로부터 생성되었습니다.:

CardProfileImporter.cs

Public 멤버 함수

정적 Private 멤버 함수

상세한 설명

멤버 함수 문서화

◆ Coalesce()

◆ DecodePhoto()

◆ DecodeQuotedPrintable()

◆ DecodeValue()

◆ First()

◆ GetCharset()

◆ ImportVCard()

◆ IsHex()

◆ Join()

◆ ParseAddress()

◆ ParseName()

◆ ReadVCardValues()

◆ UnescapeVCard()

◆ UnfoldLines()