LocalizableAttribute

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

LocalizableAttribute クラス

プロパティをローカライズする必要があるかどうかを指定します。このクラスは継承できません。

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

Visual Basic (宣言)

<AttributeUsageAttribute(AttributeTargets.All)> _
Public NotInheritable Class
 LocalizableAttribute
    Inherits Attribute

Visual Basic (使用法)

Dim instance As LocalizableAttribute

C#

[AttributeUsageAttribute(AttributeTargets.All)] 
public sealed class LocalizableAttribute :
 Attribute

C++

[AttributeUsageAttribute(AttributeTargets::All)] 
public ref class LocalizableAttribute sealed
 : public Attribute

J#

/** @attribute AttributeUsageAttribute(AttributeTargets.All) */ 
public final class LocalizableAttribute extends
 Attribute

JScript

AttributeUsageAttribute(AttributeTargets.All) 
public final class LocalizableAttribute extends
 Attribute

解説

コンポーネントのコードが生成された時点で、LocalizableAttribute に true を設定してマークされたメンバのプロパティ値はリソース ファイルに保存されています。これらのリソース ファイルは、コードを変更せずにローカライズできます。

既定では、ローカライズできる属性のないメンバまたは LocalizableAttribute に false を設定してマークされたメンバは、そのデータ型で許可されていれば、それぞれのプロパティ値をコードに対して永続化します。それ以外の場合、メイン コンポーネントが Localizable に設定されていれば、すべてのプロパティはリソース ファイルに対して永続化されます。既定値は false です。

メモ
LocalizableAttribute に true を設定してプロパティをマークすると、この属性の値は定数メンバ Yes に設定されます。LocalizableAttribute に false を設定してマークされたプロパティの場合、値は No になります。したがって、コード内でこの属性の値を確認する場合は、属性を LocalizableAttribute.Yes または LocalizableAttribute.No として指定する必要があります。

詳細については、属性の概要、属性を使用したメタデータの拡張 の各トピックを参照してください。

Topic	Location
チュートリアル : カスタム サーバー コントロールの開発と使用	ASP.NET コントロールの作成

使用例

プロパティをローカライズする必要があるとしてマークする例を次に示します。

Visual Basic

<Localizable(True)> _
Public Property MyProperty() As
 Integer
    Get
        ' Insert code here.
        Return 0
    End Get
    Set
        ' Insert code here.
    End Set 
End Property

C#

[Localizable(true)]
 public int MyProperty {
    get {
       // Insert code here.
       return 0;
    }
    set {
       // Insert code here.
    }
 }

C++

public:
   property int MyProperty 
   {
      [Localizable(true)]
      int get()
      {
         // Insert code here.
         return 0;
      }

      void set( int value
 )
      {
         // Insert code here.
      }
   }

J#

/** @attribute Localizable(true)
 */
/** @property
 */
public int get_MyProperty()
{
    // Insert code here.
    return 0;
}//get_MyProperty

/** @property 
 */
public void set_MyProperty(int
 value)
{
    // Insert code here.
}//set_MyProperty

JScript

public Localizable(true)
function get MyProperty() : int{
  // Insert code here.  Property goes on getter only when a property
 has
  // both a getter and setter.
  return 0
}

function set MyProperty(value: int){
  // Insert code here.
}

MyProperty の LocalizableAttribute の値を確認する方法を次の例に示します。最初に、オブジェクトのすべてのプロパティを保持する PropertyDescriptorCollection を取得します。次に、PropertyDescriptorCollection から MyProperty を取得します。そして、このプロパティの属性を返し、その属性を属性変数に保存します。

最後に、myAttribute を AttributeCollection にある LocalizableAttribute の値に設定し、プロパティをローカライズする必要があるかどうかを確認します。

Visual Basic

' Gets the attributes for the property.
Dim attributes As AttributeCollection = TypeDescriptor.GetProperties(Me)("MyProperty").Attributes

' Checks to see if the property needs to be localized.
Dim myAttribute As LocalizableAttribute = CType(attributes(GetType(LocalizableAttribute)),
 LocalizableAttribute)
If myAttribute.IsLocalizable Then
     ' Insert code here.
End If

C#

// Gets the attributes for the property.
AttributeCollection attributes = 
TypeDescriptor.GetProperties(this)["MyProperty"].Attributes;

// Checks to see if the property needs to be localized.
LocalizableAttribute myAttribute = 
(LocalizableAttribute)attributes[typeof(LocalizableAttribute)];
if(myAttribute.IsLocalizable) {
// Insert code here.
}

C++

// Gets the attributes for the property.
AttributeCollection^ attributes = TypeDescriptor::GetProperties( this
 )[ "MyProperty" ]->Attributes;

// Checks to see if the property needs to be localized.
LocalizableAttribute^ myAttribute = dynamic_cast<LocalizableAttribute^>(attributes[
 LocalizableAttribute::typeid ]);
if ( myAttribute->IsLocalizable )
{
   // Insert code here.
}

J#

// Gets the attributes for the property.
AttributeCollection attributes = TypeDescriptor.GetProperties(this).
    get_Item("MyProperty").get_Attributes();
// Checks to see if the property needs to be localized.
LocalizableAttribute myAttribute = (LocalizableAttribute)(attributes.
    get_Item(LocalizableAttribute.class.ToType()));
if (myAttribute.get_IsLocalizable()) {
    // Insert code here.
}

JScript

// Gets the attributes for the property.
var attributes : AttributeCollection = TypeDescriptor.GetProperties(this)["MyProperty"].Attributes

// Checks to see if the property needs to be localized.
var myAttribute : LocalizableAttribute = LocalizableAttribute(attributes(LocalizableAttribute))
if(myAttribute.IsLocalizable){
     // Insert code here.
}

継承階層

System.Object
   System.Attribute
    System.ComponentModel.LocalizableAttribute

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

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、1.1、1.0

参照

関連項目
LocalizableAttribute メンバ
System.ComponentModel 名前空間
Attribute
PropertyDescriptor
AttributeCollection クラス
PropertyDescriptorCollection

LocalizableAttribute コンストラクタ

LocalizableAttribute クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    isLocalizable As Boolean _
)

Visual Basic (使用法)

Dim isLocalizable As Boolean

Dim instance As New LocalizableAttribute(isLocalizable)

C#

public LocalizableAttribute (
    bool isLocalizable
)

C++

public:
LocalizableAttribute (
    bool isLocalizable
)

J#

public LocalizableAttribute (
    boolean isLocalizable
)

JScript

public function LocalizableAttribute (
    isLocalizable : boolean
)

パラメータ

isLocalizable

プロパティをローカライズする必要がある場合は true。それ以外の場合は false。

使用例

プロパティをローカライズする必要があるとしてマークする例を次に示します。このコードは、新しい LocalizableAttribute を作成し、その値を LocalizableAttribute.Yes に設定してから、その属性をプロパティに関連付けます。

Visual Basic

<Localizable(True)> _  
Public Property MyProperty() As
 Integer
    Get
        ' Insert code here.
        Return 0
    End Get
    Set
        ' Insert code here.
    End Set 
End Property

C#

[Localizable(true)]
public int MyProperty {
   get {
      // Insert code here.
      return 0;
   }
   set {
      // Insert code here.
   }
}
   

C++

   [Localizable(true)]
   int get()
   {
      // Insert code here.
      return 0;
   }

   void set( int value )
   {
      // Insert code here.
   }
}

J#

/** @attribute Localizable(true)
 */

/** @property 
 */
public int get_MyProperty()
{
    // Insert code here.
    return 0;
} //get_MyProperty

/** @property
 */
public void set_MyProperty(int
 value)
{
    // Insert code here.
} //set_MyProperty

JScript

public Localizable(true)
function get MyProperty() : int{
  // Insert code here.  Attribute goes on getter only when a property
 has
  // both a getter and a setter.
  return 0
}

function set MyProperty(value : int){
  // Insert code here.
}

プラットフォーム

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、1.1、1.0

参照

関連項目
LocalizableAttribute クラス
LocalizableAttribute メンバ
System.ComponentModel 名前空間
LocalizableAttribute クラス

LocalizableAttribute フィールド

パブリック フィールド

	名前	説明
	Default	既定の値である No を指定します。static フィールドは読み取り専用です。
	No	プロパティをローカライズする必要がないことを指定します。static フィールドは読み取り専用です。
	Yes	プロパティをローカライズすることを指定します。static フィールドは読み取り専用です。

参照

関連項目

LocalizableAttribute クラス
System.ComponentModel 名前空間
Attribute
PropertyDescriptor
AttributeCollection クラス
PropertyDescriptorCollection

LocalizableAttribute プロパティ

パブリック プロパティ

	名前	説明
	IsLocalizable	プロパティをローカライズする必要があるかどうかを示す値を取得します。
	TypeId	派生クラスに実装されている場合は、この Attribute の一意の識別子を取得します。 ( Attribute から継承されます。)

参照

関連項目

LocalizableAttribute クラス
System.ComponentModel 名前空間
Attribute
PropertyDescriptor
AttributeCollection クラス
PropertyDescriptorCollection

LocalizableAttribute メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 オーバーライドされます。 指定したオブジェクトの値が現在の LocalizableAttribute と等しいかどうかを示す値を返します。
	GetCustomAttribute	オーバーロードされます。 アセンブリ、モジュール、型のメンバ、またはメソッド パラメータに適用された指定した型のカスタム属性を取得します。 ( Attribute から継承されます。)
	GetCustomAttributes	オーバーロードされます。 アセンブリ、モジュール、型のメンバ、またはメソッド パラメータに適用されたカスタム属性の配列を取得します。 ( Attribute から継承されます。)
	GetHashCode	オーバーライドされます。 対象のインスタンスのハッシュ コードを返します。
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	IsDefaultAttribute	オーバーライドされます。 この属性が既定値かどうかを判断します。
	IsDefined	オーバーロードされます。 指定した型のカスタム属性が、アセンブリ、モジュール、型のメンバ、またはメソッド パラメータに適用されているかどうかを判断します。 ( Attribute から継承されます。)
	Match	派生クラス内でオーバーライドされたときに、指定したオブジェクトとこのインスタンスが等しいかどうかを示す値を返します。 ( Attribute から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

LocalizableAttribute クラス
System.ComponentModel 名前空間
Attribute
PropertyDescriptor
AttributeCollection クラス
PropertyDescriptorCollection

LocalizableAttribute メンバ

プロパティをローカライズする必要があるかどうかを指定します。このクラスは継承できません。

LocalizableAttribute データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	LocalizableAttribute	LocalizableAttribute クラスの新しいインスタンスを初期化します。

パブリック フィールド

	名前	説明
	Default	既定の値である No を指定します。static フィールドは読み取り専用です。
	No	プロパティをローカライズする必要がないことを指定します。static フィールドは読み取り専用です。
	Yes	プロパティをローカライズすることを指定します。static フィールドは読み取り専用です。

パブリック プロパティ

	名前	説明
	IsLocalizable	プロパティをローカライズする必要があるかどうかを示す値を取得します。
	TypeId	派生クラスに実装されている場合は、この Attribute の一意の識別子を取得します。(Attribute から継承されます。)

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 オーバーライドされます。 指定したオブジェクトの値が現在の LocalizableAttribute と等しいかどうかを示す値を返します。
	GetCustomAttribute	オーバーロードされます。 アセンブリ、モジュール、型のメンバ、またはメソッド パラメータに適用された指定した型のカスタム属性を取得します。 (Attribute から継承されます。)
	GetCustomAttributes	オーバーロードされます。 アセンブリ、モジュール、型のメンバ、またはメソッド パラメータに適用されたカスタム属性の配列を取得します。 (Attribute から継承されます。)
	GetHashCode	オーバーライドされます。 対象のインスタンスのハッシュ コードを返します。
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	IsDefaultAttribute	オーバーライドされます。 この属性が既定値かどうかを判断します。
	IsDefined	オーバーロードされます。 指定した型のカスタム属性が、アセンブリ、モジュール、型のメンバ、またはメソッド パラメータに適用されているかどうかを判断します。 (Attribute から継承されます。)
	Match	派生クラス内でオーバーライドされたときに、指定したオブジェクトとこのインスタンスが等しいかどうかを示す値を返します。 (Attribute から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

LocalizableAttribute クラス
System.ComponentModel 名前空間
Attribute
PropertyDescriptor
AttributeCollection クラス
PropertyDescriptorCollection