TextInfo.ReadOnly メソッド

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

TextInfo.ReadOnly メソッド

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

指定された TextInfo オブジェクトの読み取り専用バージョンを返します。

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

Visual Basic (宣言)

<ComVisibleAttribute(False)> _
Public Shared Function ReadOnly
 ( _
    textInfo As TextInfo _
) As TextInfo

Visual Basic (使用法)

Dim textInfo As TextInfo
Dim returnValue As TextInfo

returnValue = TextInfo.ReadOnly(textInfo)

C#

[ComVisibleAttribute(false)] 
public static TextInfo ReadOnly (
    TextInfo textInfo
)

C++

[ComVisibleAttribute(false)] 
public:
static TextInfo^ ReadOnly (
    TextInfo^ textInfo
)

J#

/** @attribute ComVisibleAttribute(false) */ 
public static TextInfo ReadOnly (
    TextInfo textInfo
)

JScript

ComVisibleAttribute(false) 
public static function ReadOnly
 (
    textInfo : TextInfo
) : TextInfo

パラメータ

textInfo

TextInfo オブジェクト。

戻り値
textInfo が読み取り専用の場合は、textInfo パラメータで指定された TextInfo オブジェクト。 または textInfo が読み取り専用の場合は、textInfo で指定された TextInfo オブジェクトの読み取り専用のメンバごとの複製。

例外

例外の種類	条件
ArgumentNullException	textInfo が null 参照 (Visual Basic では Nothing) です。

使用例

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

Visual Basic

' This example demonstrates the TextInfo.Clone() and
' TextInfo.ReadOnly() methods.

Imports System
Imports System.Globalization

Class Sample
    Public Shared Sub Main()
 
        ' Get the TextInfo of a predefined culture that ships with 
        ' the .NET Framework.
        Dim ci As New CultureInfo("en-US")
        Dim ti1 As TextInfo = ci.TextInfo
        
        ' Display whether the TextInfo is read-only or not.
        DisplayReadOnly("1) The original TextInfo object",
 ti1)
        Console.WriteLine()
        
        ' Create a clone of the original TextInfo and cast the clone
 to a TextInfo type.
        Console.WriteLine("2a) Create a clone of the original
 TextInfo object...")
        Dim ti2 As TextInfo = CType(ti1.Clone(),
 TextInfo)
        
        ' Display whether the clone is read-only.
        DisplayReadOnly("2b) The TextInfo clone",
 ti2)
        
        ' Set the ListSeparator property on the TextInfo clone.
        Console.WriteLine("2c) The original value of the
 clone's ListSeparator " & _
                          "property is ""{0}"".",
 ti2.ListSeparator)
        ti2.ListSeparator = "/"
        Console.WriteLine("2d) The new value of
 the clone's ListSeparator " & _ 
                          "property is ""{0}""."
 & vbCrLf, ti2.ListSeparator)
        
        ' Create a read-only clone of the original TextInfo.
        Console.WriteLine("3a) Create a read-only clone of the
 original TextInfo object...")
        Dim ti3 As TextInfo = TextInfo.ReadOnly(ti1)
        
        ' Display whether the read-only clone is actually read-only.
        DisplayReadOnly("3b) The TextInfo clone",
 ti3)
        
        ' Try to set the ListSeparator property of a read-only TextInfo
 object. Use the
        ' IsReadOnly property again to determine whether to attempt
 the set operation. You 
        ' could use a try-catch block instead and catch an InvalidOperationException
 when
        ' the set operation fails, but that programming technique is
 inefficient.
        Console.WriteLine("3c) Try to
 set the read-only clone's LineSeparator property.")
        If ti3.IsReadOnly = True Then
            Console.WriteLine("3d) The set operation is invalid.")
        Else
            ' This clause is not executed.
            ti3.ListSeparator = "/"
            Console.WriteLine("3d) The new value of
 the clone's ListSeparator " & _ 
                              "property is ""{0}""."
 & vbCrLf, ti2.ListSeparator)
        End If
    
    End Sub 'Main
    
    Private Shared Sub DisplayReadOnly(ByVal
 caption As String, ByVal
 ti As TextInfo)
        Dim middle As String
        If ti.IsReadOnly = True Then
            middle = ""
        Else 
            middle = "not "
        End If        
        Console.WriteLine("{0} is {1}read-only.",
 caption, middle)
    End Sub 'DisplayReadOnly
End Class 'Sample

'
'This code example produces the following results:
'
'1) The original TextInfo object is not read-only.
'
'2a) Create a clone of the original TextInfo object...
'2b) The TextInfo clone is not read-only.
'2c) The original value of the clone's ListSeparator property is "
,".
'2d) The new value of the clone's ListSeparator property is "/".
'
'3a) Create a read-only clone of the original TextInfo object...
'3b) The TextInfo clone is read-only.
'3c) Try to set the read-only clone's LineSeparator property.
'3d) The set operation is invalid.
'

C#

// This example demonstrates the TextInfo.Clone() and
// TextInfo.ReadOnly() methods.

using System;
using System.Globalization;

class Sample 
{
    public static void Main()
 
    {
// Get the TextInfo of a predefined culture that ships with 
// the .NET Framework.
    CultureInfo ci = new CultureInfo("en-US");
    TextInfo ti1 = ci.TextInfo;

// Display whether the TextInfo is read-only or not.
    DisplayReadOnly("1) The original TextInfo object", ti1);
    Console.WriteLine();
   
// Create a clone of the original TextInfo and cast the clone to a TextInfo
 type.
    Console.WriteLine("2a) Create a clone of the original TextInfo object...");
    TextInfo ti2 = (TextInfo)ti1.Clone();

// Display whether the clone is read-only.
    DisplayReadOnly("2b) The TextInfo clone", ti2);

// Set the ListSeparator property on the TextInfo clone.
    Console.WriteLine("2c) The original value of the clone's ListSeparator "
 +
                      "property is \"{0}\".", ti2.ListSeparator);
    ti2.ListSeparator = "/";
    Console.WriteLine("2d) The new value of the clone's ListSeparator
 " +
                      "property is \"{0}\".\n", ti2.ListSeparator);

// Create a read-only clone of the original TextInfo.
    Console.WriteLine("3a) Create a read-only clone of the original TextInfo
 object...");
    TextInfo ti3 = TextInfo.ReadOnly(ti1);

// Display whether the read-only clone is actually read-only.
    DisplayReadOnly("3b) The TextInfo clone", ti3);

// Try to set the ListSeparator property of a read-only TextInfo object.
 Use the
// IsReadOnly property again to determine whether to attempt the set
 operation. You 
// could use a try-catch block instead and catch an InvalidOperationException
 when
// the set operation fails, but that programming technique is inefficient.
    Console.WriteLine("3c) Try to set the read-only clone's
 LineSeparator " +
                      "property.");
    if (ti3.IsReadOnly == true)
        {
        Console.WriteLine("3d) The set operation is invalid.");
        }
    else
        {
        // This clause is not executed.
        ti3.ListSeparator = "/";
        Console.WriteLine("3d) The new value of the clone's
 ListSeparator " +
                          "property is \"{0}\".\n", ti2.ListSeparator);
        }
    }

    private static void
 DisplayReadOnly(string caption, TextInfo ti)
    {
    Console.WriteLine("{0} is {1}read-only.", 
                      caption, ti.IsReadOnly ? "" : "not ");
    }
}

/*
This code example produces the following results:

1) The original TextInfo object is not read-only.

2a) Create a clone of the original TextInfo object...
2b) The TextInfo clone is not read-only.
2c) The original value of the clone's ListSeparator property is ",".
2d) The new value of the clone's ListSeparator property is "/".

3a) Create a read-only clone of the original TextInfo object...
3b) The TextInfo clone is read-only.
3c) Try to set the read-only clone's LineSeparator property.
3d) The set operation is invalid.

*/

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
TextInfo クラス
TextInfo メンバ
System.Globalization 名前空間
MemberwiseClone