IdnMapping.GetAscii メソッド

定義

US-ASCII 文字の範囲外の Unicode 文字を含むドメイン名ラベルの文字列を、US-ASCII 文字範囲 (U+0020 から U+007E) の表示可能な Unicode 文字から構成される文字列にエンコードします。 文字列は IDNA 標準に従って書式設定されます。

オーバーロード

GetAscii(String)

Unicode 文字から構成されるドメイン名ラベルの文字列を、US-ASCII 文字範囲の表示可能な Unicode 文字から構成される文字列にエンコードします。 文字列は IDNA 標準に従って書式設定されます。

GetAscii(String, Int32)

US-ASCII 文字範囲外の Unicode 文字を含むドメイン名ラベルの部分文字列をエンコードします。 部分文字列は US-ASCII 文字範囲の表示可能な Unicode 文字の文字列に変換され、IDNA 基準に従って書式化されます。

GetAscii(String, Int32, Int32)

US-ASCII 文字範囲外の Unicode 文字を含むドメイン名ラベルの部分文字列で、指定した文字数をエンコードします。 部分文字列は US-ASCII 文字範囲の表示可能な Unicode 文字の文字列に変換され、IDNA 基準に従って書式化されます。

GetAscii(String)

ソース:
IdnMapping.cs
ソース:
IdnMapping.cs
ソース:
IdnMapping.cs

Unicode 文字から構成されるドメイン名ラベルの文字列を、US-ASCII 文字範囲の表示可能な Unicode 文字から構成される文字列にエンコードします。 文字列は IDNA 標準に従って書式設定されます。

public:
 System::String ^ GetAscii(System::String ^ unicode);
public string GetAscii (string unicode);
member this.GetAscii : string -> string
Public Function GetAscii (unicode As String) As String

パラメーター

unicode
String

ラベル区切り記号で区切られた 1 つまたは複数のドメイン名ラベルから構成される、変換対象の入力文字列。

戻り値

unicode パラメーターによって指定された文字列に対応する、US-ASCII 文字範囲 (U+0020 から U+007E) の表示可能な Unicode 文字から構成され、IDNA 標準に従って書式化された文字列。

例外

unicodenullです。

unicode は、AllowUnassigned プロパティ、UseStd3AsciiRules プロパティ、IDNA 標準に対して無効です。

次の例では、 メソッドを GetAscii(String) 使用して、国際化ドメイン名の配列を Punycode に変換します。これは、US-ASCII 文字範囲の文字で構成されるエンコードされた同等のコードです。 次に、 メソッドは GetUnicode(String) Punycode ドメイン名を元のドメイン名に変換しますが、元のラベル区切り記号を標準のラベル区切り記号に置き換えます。

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      string[] names = { "bücher.com", "мойдомен.рф", "παράδειγμα.δοκιμή",
                         "mycharity\u3002org",
                         "prose\u0000ware.com", "proseware..com", "a.org",
                         "my_company.com" };
      IdnMapping idn = new IdnMapping();

      foreach (var name in names) {
         try {
            string punyCode = idn.GetAscii(name);
            string name2 = idn.GetUnicode(punyCode);
            Console.WriteLine("{0} --> {1} --> {2}", name, punyCode, name2);
            Console.WriteLine("Original: {0}", ShowCodePoints(name));
            Console.WriteLine("Restored: {0}", ShowCodePoints(name2));
         }
         catch (ArgumentException) {
            Console.WriteLine("{0} is not a valid domain name.", name);
         }
         Console.WriteLine();
      }
   }

   private static string ShowCodePoints(string str1)
   {
      string output = "";
      foreach (var ch in str1)
         output += $"U+{(ushort)ch:X4} ";

      return output;
   }
}
// The example displays the following output:
//    bücher.com --> xn--bcher-kva.com --> bücher.com
//    Original: U+0062 U+00FC U+0063 U+0068 U+0065 U+0072 U+002E U+0063 U+006F U+006D
//    Restored: U+0062 U+00FC U+0063 U+0068 U+0065 U+0072 U+002E U+0063 U+006F U+006D
//
//    мойдомен.рф --> xn--d1acklchcc.xn--p1ai --> мойдомен.рф
//    Original: U+043C U+043E U+0439 U+0434 U+043E U+043C U+0435 U+043D U+002E U+0440 U+0444
//    Restored: U+043C U+043E U+0439 U+0434 U+043E U+043C U+0435 U+043D U+002E U+0440 U+0444
//
//    παράδειγμα.δοκιμή --> xn--hxajbheg2az3al.xn--jxalpdlp --> παράδειγμα.δοκιμή
//    Original: U+03C0 U+03B1 U+03C1 U+03AC U+03B4 U+03B5 U+03B9 U+03B3 U+03BC U+03B1 U+002E U+03B4 U+03BF U+03BA U+03B9 U+03BC U+03AE
//    Restored: U+03C0 U+03B1 U+03C1 U+03AC U+03B4 U+03B5 U+03B9 U+03B3 U+03BC U+03B1 U+002E U+03B4 U+03BF U+03BA U+03B9 U+03BC U+03AE
//
//    mycharity。org --> mycharity.org --> mycharity.org
//    Original: U+006D U+0079 U+0063 U+0068 U+0061 U+0072 U+0069 U+0074 U+0079 U+3002 U+006F U+0072 U+0067
//    Restored: U+006D U+0079 U+0063 U+0068 U+0061 U+0072 U+0069 U+0074 U+0079 U+002E U+006F U+0072 U+0067
//
//    prose ware.com is not a valid domain name.
//
//    proseware..com is not a valid domain name.
//
//    a.org --> a.org --> a.org
//    Original: U+0061 U+002E U+006F U+0072 U+0067
//    Restored: U+0061 U+002E U+006F U+0072 U+0067
//
//    my_company.com --> my_company.com --> my_company.com
//    Original: U+006D U+0079 U+005F U+0063 U+006F U+006D U+0070 U+0061 U+006E U+0079 U+002E U+0063 U+006F U+006D
//    Restored: U+006D U+0079 U+005F U+0063 U+006F U+006D U+0070 U+0061 U+006E U+0079 U+002E U+0063 U+006F U+006D
Imports System.Globalization

Module Example
   Public Sub Main()
      Dim names() As String = { "bücher.com", "мойдомен.рф", "παράδειγμα.δοκιμή",
                                "mycharity" + ChrW(&h3002) + "org",
                                "prose" + ChrW(0) + "ware.com", "proseware..com", "a.org", 
                                "my_company.com" }
      Dim idn As New IdnMapping()
      
      For Each name In names
         Try
            Dim punyCode As String = idn.GetAscii(name)
            Dim name2 As String = idn.GetUnicode(punyCode)
            Console.WriteLine("{0} --> {1} --> {2}", name, punyCode, name2) 
            Console.WriteLine("Original: {0}", ShowCodePoints(name))
            Console.WriteLine("Restored: {0}", ShowCodePoints(name2))
         Catch e As ArgumentException 
            Console.WriteLine("{0} is not a valid domain name.", name)
         End Try
         Console.WriteLine()
      Next   
   End Sub
   
   Private Function ShowCodePoints(str1 As String) As String
      Dim output As String = ""
      For Each ch In str1
         output += String.Format("U+{0} ", Convert.ToUInt16(ch).ToString("X4"))
      Next
      Return output
   End Function
End Module
' The example displays the following output:
'    bücher.com --> xn--bcher-kva.com --> bücher.com
'    Original: U+0062 U+00FC U+0063 U+0068 U+0065 U+0072 U+002E U+0063 U+006F U+006D
'    Restored: U+0062 U+00FC U+0063 U+0068 U+0065 U+0072 U+002E U+0063 U+006F U+006D
'    
'    мойдомен.рф --> xn--d1acklchcc.xn--p1ai --> мойдомен.рф
'    Original: U+043C U+043E U+0439 U+0434 U+043E U+043C U+0435 U+043D U+002E U+0440 U+0444
'    Restored: U+043C U+043E U+0439 U+0434 U+043E U+043C U+0435 U+043D U+002E U+0440 U+0444
'    
'    παράδειγμα.δοκιμή --> xn--hxajbheg2az3al.xn--jxalpdlp --> παράδειγμα.δοκιμή
'    Original: U+03C0 U+03B1 U+03C1 U+03AC U+03B4 U+03B5 U+03B9 U+03B3 U+03BC U+03B1 U+002E U+03B4 U+03BF U+03BA U+03B9 U+03BC U+03AE
'    Restored: U+03C0 U+03B1 U+03C1 U+03AC U+03B4 U+03B5 U+03B9 U+03B3 U+03BC U+03B1 U+002E U+03B4 U+03BF U+03BA U+03B9 U+03BC U+03AE
'    
'    mycharity。org --> mycharity.org --> mycharity.org
'    Original: U+006D U+0079 U+0063 U+0068 U+0061 U+0072 U+0069 U+0074 U+0079 U+3002 U+006F U+0072 U+0067
'    Restored: U+006D U+0079 U+0063 U+0068 U+0061 U+0072 U+0069 U+0074 U+0079 U+002E U+006F U+0072 U+0067
'    
'    prose ware.com is not a valid domain name.
'    
'    proseware..com is not a valid domain name.
'    
'    a.org --> a.org --> a.org
'    Original: U+0061 U+002E U+006F U+0072 U+0067
'    Restored: U+0061 U+002E U+006F U+0072 U+0067
'    
'    my_company.com --> my_company.com --> my_company.com
'    Original: U+006D U+0079 U+005F U+0063 U+006F U+006D U+0070 U+0061 U+006E U+0079 U+002E U+0063 U+006F U+006D
'    Restored: U+006D U+0079 U+005F U+0063 U+006F U+006D U+0070 U+0061 U+006E U+0079 U+002E U+0063 U+006F U+006D

注釈

パラメーターは unicode 、有効な Unicode 文字で構成される 1 つ以上のラベルの文字列を指定します。 ラベルはラベル区切り記号で区切られます。 パラメーターは unicode ラベル区切り記号で始めることはできませんが、区切り記号を含め、必要に応じて末尾に区切り記号を付けることができます。 ラベル区切り記号は、FULL STOP (ピリオド、U+002E)、IDEOGRAPHIC FULL STOP (U+3002)、FULLWIDTH FULL STOP (U+FF0E)、HALFWIDTH IDEOGRAPHIC FULL STOP (U+FF61) です。 たとえば、ドメイン名 "www.adatum.com" は、ラベル "www"、"adatum"、"com" で構成され、ピリオドで区切られます。

ラベルには、次の文字を含めることはできません。

メソッドは GetAscii 、すべてのラベル区切り記号を FULL STOP (ピリオド、U+002E) に変換します。

US-ASCII 文字範囲外の文字が含まれない場合、および US-ASCII 文字範囲内の文字が禁止されていない場合 unicode 、メソッドは変更せずにを返します unicode

注意 (呼び出し元)

.NET Framework 4.5 では、IdnMapping使用しているオペレーティング システムに応じて、クラスでさまざまなバージョンの IDNA 標準がサポートされています。

これらの標準が特定の文字セットを処理する方法の違いについては、「 Unicode Technical Standard #46: IDNA 互換性処理 」を参照してください。

適用対象

GetAscii(String, Int32)

ソース:
IdnMapping.cs
ソース:
IdnMapping.cs
ソース:
IdnMapping.cs

US-ASCII 文字範囲外の Unicode 文字を含むドメイン名ラベルの部分文字列をエンコードします。 部分文字列は US-ASCII 文字範囲の表示可能な Unicode 文字の文字列に変換され、IDNA 基準に従って書式化されます。

public:
 System::String ^ GetAscii(System::String ^ unicode, int index);
public string GetAscii (string unicode, int index);
member this.GetAscii : string * int -> string
Public Function GetAscii (unicode As String, index As Integer) As String

パラメーター

unicode
String

ラベル区切り記号で区切られた 1 つまたは複数のドメイン名ラベルから構成される、変換対象の入力文字列。

index
Int32

変換する部分文字列の始まりを指定する unicode への 0 から始まるオフセット。 変換演算は、unicode 文字列の終わりまで続行されます。

戻り値

unicode パラメーターと index パラメーターによって指定された部分文字列に対応する、US-ASCII 文字範囲 (U+0020 から U+007E) の表示可能な Unicode 文字から構成され、IDNA 標準に従って書式化された部分文字列。

例外

unicodenull です。

index が 0 未満です。

または

indexunicode の長さを超えています。

unicode は、AllowUnassigned プロパティ、UseStd3AsciiRules プロパティ、IDNA 標準に対して無効です。

注釈

パラメーターと index パラメーターはunicode、有効な Unicode 文字で構成される 1 つ以上のラベルを持つ部分文字列を定義します。 ラベルはラベル区切り記号で区切られます。 部分文字列の最初の文字はラベル区切り文字で始めることはできませんが、区切り記号を含め、必要に応じて末尾に区切り記号を付けることができます。 ラベル区切り記号は、FULL STOP (ピリオド、U+002E)、IDEOGRAPHIC FULL STOP (U+3002)、FULLWIDTH FULL STOP (U+FF0E)、HALFWIDTH IDEOGRAPHIC FULL STOP (U+FF61) です。 たとえば、ドメイン名 "www.adatum.com" は、ラベル "www"、"adatum"、"com" で構成され、ピリオドで区切られます。

ラベルには、次の文字を含めることはできません。

メソッドは GetAscii 、すべてのラベル区切り記号を FULL STOP (ピリオド、U+002E) に変換します。

US-ASCII 文字範囲外の文字が含まれない場合、および US-ASCII 文字範囲内の文字が禁止されていない場合 unicode 、メソッドは変更せずにを返します unicode

注意 (呼び出し元)

.NET Framework 4.5 では、IdnMapping使用しているオペレーティング システムに応じて、クラスでさまざまなバージョンの IDNA 標準がサポートされています。

これらの標準が特定の文字セットを処理する方法の違いについては、「 Unicode Technical Standard #46: IDNA 互換性処理 」を参照してください。

適用対象

GetAscii(String, Int32, Int32)

ソース:
IdnMapping.cs
ソース:
IdnMapping.cs
ソース:
IdnMapping.cs

US-ASCII 文字範囲外の Unicode 文字を含むドメイン名ラベルの部分文字列で、指定した文字数をエンコードします。 部分文字列は US-ASCII 文字範囲の表示可能な Unicode 文字の文字列に変換され、IDNA 基準に従って書式化されます。

public:
 System::String ^ GetAscii(System::String ^ unicode, int index, int count);
public string GetAscii (string unicode, int index, int count);
member this.GetAscii : string * int * int -> string
Public Function GetAscii (unicode As String, index As Integer, count As Integer) As String

パラメーター

unicode
String

ラベル区切り記号で区切られた 1 つまたは複数のドメイン名ラベルから構成される、変換対象の入力文字列。

index
Int32

部分文字列の始まりを指定する unicode への 0 から始まるオフセット。

count
Int32

unicode 文字列の index で指定された位置から始まる部分文字列内の変換対象の文字の数。

戻り値

unicode パラメーター、index パラメーター、count パラメーターによって指定された部分文字列に対応する、US-ASCII 文字範囲 (U+0020 から U+007E) の表示可能な Unicode 文字から構成され、IDNA 標準に従って書式化された部分文字列。

例外

unicodenullです。

index または count が 0 未満です。

または

indexunicode の長さを超えています。

または

index が、unicode から count を引いた長さを超えています。

unicode は、AllowUnassigned プロパティ、UseStd3AsciiRules プロパティ、IDNA 標準に対して無効です。

次の例では、 メソッドを GetAscii(String, Int32, Int32) 使用して、国際化ドメイン名を IDNA 標準に準拠するドメイン名に変換します。 次に、 メソッドは GetUnicode(String, Int32, Int32) 標準化されたドメイン名を元のドメイン名に変換しますが、元のラベル区切り記号を標準のラベル区切り記号に置き換えます。

// This example demonstrates the GetAscii and GetUnicode methods.
// For sake of illustration, this example uses the most complex
// form of those methods, not the most convenient.

using System;
using System.Globalization;

class Sample
{
    public static void Main()
    {
/*
   Define a domain name consisting of the labels: GREEK SMALL LETTER
   PI (U+03C0); IDEOGRAPHIC FULL STOP (U+3002); GREEK SMALL LETTER
   THETA (U+03B8); FULLWIDTH FULL STOP (U+FF0E); and "com".
*/
    string name = "\u03C0\u3002\u03B8\uFF0Ecom";
    string international;
    string nonInternational;

    string msg1 = "the original non-internationalized \ndomain name:";
    string msg2 = "Allow unassigned characters?:     {0}";
    string msg3 = "Use non-internationalized rules?: {0}";
    string msg4 = "Convert the non-internationalized domain name to international format...";
    string msg5 = "Display the encoded domain name:\n\"{0}\"";
    string msg6 = "the encoded domain name:";
    string msg7 = "Convert the internationalized domain name to non-international format...";
    string msg8 = "the reconstituted non-internationalized \ndomain name:";
    string msg9 = "Visually compare the code points of the reconstituted string to the " +
                  "original.\n" +
                  "Note that the reconstituted string contains standard label " +
                  "separators (U+002e).";
// ----------------------------------------------------------------------------
    CodePoints(name, msg1);
// ----------------------------------------------------------------------------

    IdnMapping idn = new IdnMapping();

    Console.WriteLine(msg2, idn.AllowUnassigned);
    Console.WriteLine(msg3, idn.UseStd3AsciiRules);
    Console.WriteLine();
// ----------------------------------------------------------------------------
    Console.WriteLine(msg4);
    international = idn.GetAscii(name, 0, name.Length);
    Console.WriteLine(msg5, international);
    Console.WriteLine();
    CodePoints(international, msg6);
// ----------------------------------------------------------------------------
    Console.WriteLine(msg7);
    nonInternational = idn.GetUnicode(international, 0, international.Length);
    CodePoints(nonInternational, msg8);
    Console.WriteLine(msg9);
    }
// ----------------------------------------------------------------------------
    static void CodePoints(string value, string title)
    {
    Console.WriteLine("Display the Unicode code points of {0}", title);
    foreach (char c in value)
        {
        Console.Write("{0:x4} ", Convert.ToInt32(c));
        }
        Console.WriteLine();
        Console.WriteLine();
    }
}
/*
This code example produces the following results:

Display the Unicode code points of the original non-internationalized
domain name:
03c0 3002 03b8 ff0e 0063 006f 006d

Allow unassigned characters?:     False
Use non-internationalized rules?: False

Convert the non-internationalized domain name to international format...
Display the encoded domain name:
"xn--1xa.xn--txa.com"

Display the Unicode code points of the encoded domain name:
0078 006e 002d 002d 0031 0078 0061 002e 0078 006e 002d 002d 0074 0078 0061 002e 0063 006f
006d

Convert the internationalized domain name to non-international format...
Display the Unicode code points of the reconstituted non-internationalized
domain name:
03c0 002e 03b8 002e 0063 006f 006d

Visually compare the code points of the reconstituted string to the original.
Note that the reconstituted string contains standard label separators (U+002e).

*/
' This example demonstrates the GetAscii and GetUnicode methods.
' For sake of illustration, this example uses the most complex
' form of those methods, not the most convenient.

Imports System.Globalization

Class Sample
    Public Shared Sub Main()

'   Define a domain name consisting of the labels: GREEK SMALL LETTER
'   PI (U+03C0); IDEOGRAPHIC FULL STOP (U+3002); GREEK SMALL LETTER
'   THETA (U+03B8); FULLWIDTH FULL STOP (U+FF0E); and "com".

        Dim name As String = "π。θ.com"
        Dim international As String
        Dim nonInternational As String

        Dim msg1 As String = "the original non-internationalized " & vbCrLf & "domain name:"
        Dim msg2 As String = "Allow unassigned characters?:     {0}"
        Dim msg3 As String = "Use non-internationalized rules?: {0}"
        Dim msg4 As String = "Convert the non-internationalized domain name to international format..."
        Dim msg5 As String = "Display the encoded domain name:" & vbCrLf & """{0}"""
        Dim msg6 As String = "the encoded domain name:"
        Dim msg7 As String = "Convert the internationalized domain name to non-international format..."
        Dim msg8 As String = "the reconstituted non-internationalized " & vbCrLf & "domain name:"
        Dim msg9 As String = "Visually compare the code points of the reconstituted string to the " & _
                             "original." & vbCrLf & _
                             "Note that the reconstituted string contains standard label " & _
                             "separators (U+002e)."
        ' ----------------------------------------------------------------------------
        CodePoints(name, msg1)
        ' ----------------------------------------------------------------------------
        Dim idn As New IdnMapping()

        Console.WriteLine(msg2, idn.AllowUnassigned)
        Console.WriteLine(msg3, idn.UseStd3AsciiRules)
        Console.WriteLine()
        ' ----------------------------------------------------------------------------
        Console.WriteLine(msg4)
        international = idn.GetAscii(name, 0, name.Length)
        Console.WriteLine(msg5, international)
        Console.WriteLine()
        CodePoints(international, msg6)
        ' ----------------------------------------------------------------------------
        Console.WriteLine(msg7)
        nonInternational = idn.GetUnicode(international, 0, international.Length)
        CodePoints(nonInternational, msg8)
        Console.WriteLine(msg9)
    End Sub

    ' ----------------------------------------------------------------------------
    Shared Sub CodePoints(ByVal value As String, ByVal title As String)
        Console.WriteLine("Display the Unicode code points of {0}", title)
        Dim c As Char
        For Each c In  value
            Console.Write("{0:x4} ", Convert.ToInt32(c))
        Next c
        Console.WriteLine()
        Console.WriteLine()

    End Sub
End Class
'
'This code example produces the following results:
'
'Display the Unicode code points of the original non-internationalized
'domain name:
'03c0 3002 03b8 ff0e 0063 006f 006d
'
'Allow unassigned characters?:     False
'Use non-internationalized rules?: False
'
'Convert the non-internationalized domain name to international format...
'Display the encoded domain name:
'"xn--1xa.xn--txa.com"
'
'Display the Unicode code points of the encoded domain name:
'0078 006e 002d 002d 0031 0078 0061 002e 0078 006e 002d 002d 0074 0078 0061 002e 0063 006f
'006d
'
'Convert the internationalized domain name to non-international format...
'Display the Unicode code points of the reconstituted non-internationalized
'domain name:
'03c0 002e 03b8 002e 0063 006f 006d
'
'Visually compare the code points of the reconstituted string to the original.
'Note that the reconstituted string contains standard label separators (U+002e).
'

注釈

index、および count パラメーターはUnicode、有効な Unicode 文字で構成される 1 つ以上のラベルを持つ部分文字列を定義します。 ラベルはラベル区切り記号で区切られます。 部分文字列の最初の文字はラベル区切り文字で始めることはできませんが、区切り記号を含め、必要に応じて末尾に区切り記号を付けることができます。 ラベル区切り記号は、FULL STOP (ピリオド、U+002E)、IDEOGRAPHIC FULL STOP (U+3002)、FULLWIDTH FULL STOP (U+FF0E)、HALFWIDTH IDEOGRAPHIC FULL STOP (U+FF61) です。 たとえば、ドメイン名 "www.adatum.com" は、ラベル "www"、"adatum"、"com" で構成され、ピリオドで区切られます。

ラベルには、次の文字を含めることはできません。

メソッドは GetAscii 、すべてのラベル区切り記号を FULL STOP (ピリオド、U+002E) に変換します。 部分文字列に US-ASCII 文字範囲外の文字が含まれない場合、および US-ASCII 文字範囲内の文字が禁止されていない場合、メソッドはサブ文字列を変更せずに返します。

注意 (呼び出し元)

.NET Framework 4.5 では、IdnMapping使用しているオペレーティング システムに応じて、クラスでさまざまなバージョンの IDNA 標準がサポートされています。

これらの標準が特定の文字セットを処理する方法の違いについては、「 Unicode Technical Standard #46: IDNA 互換性処理 」を参照してください。

適用対象