LocalizableAttribute クラスとは何？わかりやすく解説 Weblio辞書

.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

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

C++

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

/** @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 として指定する必要があります。

メモ

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

[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.
      }
   }

/** @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

// 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.
}

// 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.
}