CultureAndRegionInfoBuilder.CreateFromLdml メソッドとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

CultureAndRegionInfoBuilder.CreateFromLdml メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

指定したオブジェクトの表現を含む XML ファイルから CultureAndRegionInfoBuilder オブジェクトを再構成します。

名前空間: System.Globalization
アセンブリ: sysglobl (sysglobl.dll 内)
構文

Visual Basic (宣言)

Public Shared Function CreateFromLdml
 ( _
    xmlFileName As String _
) As CultureAndRegionInfoBuilder

Visual Basic (使用法)

Dim xmlFileName As String
Dim returnValue As CultureAndRegionInfoBuilder

returnValue = CultureAndRegionInfoBuilder.CreateFromLdml(xmlFileName)

public static CultureAndRegionInfoBuilder CreateFromLdml
 (
    string xmlFileName
)

C++

public:
static CultureAndRegionInfoBuilder^ CreateFromLdml (
    String^ xmlFileName
)

public static CultureAndRegionInfoBuilder CreateFromLdml
 (
    String xmlFileName
)

JScript

public static function CreateFromLdml
 (
    xmlFileName : String
) : CultureAndRegionInfoBuilder

パラメータ

xmlFileName: CultureAndRegionInfoBuilder オブジェクトの XML 表現を含むファイルの名前。

戻り値
xmlFileName パラメータに格納されている情報と等価の新しい CultureAndRegionInfoBuilder オブジェクト。

例外

例外の種類	条件
ArgumentNullException	xmlFileName が null 参照 (Visual Basic では Nothing) です。
ArgumentException	xmlFileName は、空の文字列 ("") か、または無効なファイルまたはパス名です。
XmlException	xmlFileName のデータが有効な XML 形式ではありません。または xmlFileName にアクセスしているときに、I/O エラーが発生しました。
XmlSchemaValidationException	xmlFileName のデータが有効な LDML 形式ではありません。

解説

CultureAndRegionInfoBuilder オブジェクトの XML 表現を含むファイルの名前を指定する xmlFileName パラメータ。XML ファイルの形式は、LDML (Locale Data Markup Language) バージョン 1.1 と呼ばれます。新しい CultureAndRegionInfoBuilder オブジェクトが作成され、xmlFileName のデータで初期化されます。

Save メソッドは、CreateFromLdml メソッドと逆の操作を実行します。

LDML 標準の詳細については、Unicode Home Page の『Unicode Technical Standard #35』の「Locale Data Markup Language (LDML)」を参照してください。

使用例

Save メソッドおよび CreateFromLdml メソッドのコード例を次に示します。

Visual Basic

' This example demonstrates the CultureAndRegionInfoBuilder.Save and
 
' CreateFromLdml methods.
' Compile this example with a reference to sysglobl.dll.

Imports System
Imports System.Globalization
Imports System.IO
Imports System.Xml

Class Sample
    Public Shared Sub Main()
 
        Dim savedCARIB As String
 = "mySavedCARIB.xml"
        Dim msg1 As String
 = "The name of the original CultureAndRegionInfoBuilder"
 & _
                             " is ""{0}""."
        Dim msg2 As String
 = "Reconstituting the CultureAndRegionInfoBuilder object "
 & _
                             "from ""{0}""."
        Dim msg3 As String
 = "The name of the reconstituted CultureAndRegionInfoBuilder"
 & _
                             " is ""{0}""."

        ' Construct a new, privately used culture that extends the en-US
 culture 
        ' provided by the .NET Framework. In this sample, the CultureAndRegion-
        ' Types.Specific parameter creates a minimal CultureAndRegionInfoBuilder
 
        ' object that you must populate with culture and region information.

        Dim cib1 As CultureAndRegionInfoBuilder
 = Nothing
        Dim cib2 As CultureAndRegionInfoBuilder
 = Nothing
        
        Try
            cib1 = New CultureAndRegionInfoBuilder("x-en-US-sample",
 _
                                        CultureAndRegionModifiers.None)
        Catch ae As ArgumentException
            Console.WriteLine(ae)
            Return
        End Try
        
        ' Populate the new CultureAndRegionInfoBuilder object with culture
 information.
        Dim ci As New CultureInfo("en-US")
        cib1.LoadDataFromCultureInfo(ci)
        
        ' Populate the new CultureAndRegionInfoBuilder object with region
 information.
        Dim ri As New RegionInfo("US")
        cib1.LoadDataFromRegionInfo(ri)
        
        ' Display a property of the new custom culture.
        Console.Clear()
        Console.WriteLine(msg1, cib1.CultureName)
        
        ' Save the new CultureAndRegionInfoBuilder object in the specified
 file in
        ' LDML format. The file is saved in the same directory as the
 application 
        ' that calls the Save method.

        Console.WriteLine("Saving the custom culture to a file...")
        Try
            cib1.Save(savedCARIB)
        Catch exc As IOException
            Console.WriteLine("** I/O exception: {0}",
 exc.Message)
            Return
        End Try
        
        ' Create a new CultureAndRegionInfoBuilder object from the persisted
 file.
        Console.WriteLine(msg2, savedCARIB)
        Try
            cib2 = CultureAndRegionInfoBuilder.CreateFromLdml(savedCARIB)
        Catch xe As XmlException
            Console.WriteLine("** XML validation exception: {0}",
 xe.Message)
            Return
        End Try
        
        ' Display a property of the resonstituted custom culture.
        Console.WriteLine(msg3, cib2.CultureName)

        ' At this point you could call the Register method and make
 the reconstituted
        ' custom culture available to other applications. The mySavedCARIB.xml
 file
        ' remains on your computer.

    End Sub 'Main ' 
End Class 'Sample

'This code example produces the following results:
'
'The name of the original CultureAndRegionInfoBuilder is "x-en-US-sample".
'Saving the custom culture to a file...
'Reconstituting the CultureAndRegionInfoBuilder object from "mySavedCARIB.xml".
'The name of the reconstituted CultureAndRegionInfoBuilder is "x-en-US-sample".
'

// This example demonstrates the CultureAndRegionInfoBuilder.Save and
 
// CreateFromLdml methods.
// Compile this example with a reference to sysglobl.dll.

using System;
using System.Globalization;
using System.IO;
using System.Xml;

class Sample 
{
    public static void Main()
 
    {
    string savedCARIB = "mySavedCARIB.xml";
    string msg1 = "The name of the original CultureAndRegionInfoBuilder"
 +
                  " is \"{0}\".";
    string msg2 = "Reconstituting the CultureAndRegionInfoBuilder
 object " +
                  "from \"{0}\".";
    string msg3 = "The name of the reconstituted CultureAndRegionInfoBuilder"
 +
                  " is \"{0}\".";

// Construct a new, privately used culture that extends the en-US culture
 
// provided by the .NET Framework. In this sample, the CultureAndRegion-
// Types.Specific parameter creates a minimal CultureAndRegionInfoBuilder
 
// object that you must populate with culture and region information.

    CultureAndRegionInfoBuilder cib1 = null;
    CultureAndRegionInfoBuilder cib2 = null;
    try {
        cib1 = new CultureAndRegionInfoBuilder(
                           "x-en-US-sample", CultureAndRegionModifiers.None);
        }
    catch (ArgumentException ae)
        {
        Console.WriteLine(ae);
        return;
        }

// Populate the new CultureAndRegionInfoBuilder object with culture
 information.
    CultureInfo ci = new CultureInfo("en-US");
    cib1.LoadDataFromCultureInfo(ci);

// Populate the new CultureAndRegionInfoBuilder object with region information.
    RegionInfo  ri = new RegionInfo("US");
    cib1.LoadDataFromRegionInfo(ri);

// Display a property of the new custom culture.
    Console.Clear();
    Console.WriteLine(msg1, cib1.CultureName);

// Save the new CultureAndRegionInfoBuilder object in the specified
 file in
// LDML format. The file is saved in the same directory as the application
 
// that calls the Save method.

    Console.WriteLine("Saving the custom culture to a file...");
    try {
        cib1.Save( savedCARIB );
        }
    catch (IOException exc)
        {
        Console.WriteLine("** I/O exception: {0}", exc.Message);
        return;
        }

// Create a new CultureAndRegionInfoBuilder object from the persisted
 file.
    Console.WriteLine(msg2, savedCARIB);
    try {
        cib2 = CultureAndRegionInfoBuilder.CreateFromLdml( savedCARIB );
        }
    catch (XmlException xe)
        {
        Console.WriteLine("** XML validation exception: {0}", xe.Message);
        return;
        }

// Display a property of the resonstituted custom culture.
    Console.WriteLine(msg3, cib2.CultureName);

// At this point you could call the Register method and make the reconstituted
// custom culture available to other applications. The mySavedCARIB.xml
 file
// remains on your computer.
    }
}

/*
This code example produces the following results:

The name of the original CultureAndRegionInfoBuilder is "x-en-US-sample".
Saving the custom culture to a file...
Reconstituting the CultureAndRegionInfoBuilder object from "mySavedCARIB.xml".
The name of the reconstituted CultureAndRegionInfoBuilder is "x-en-US-sample".

*/