AttributeCollection.Matches メソッド

定義

名前空間:

System.ComponentModel

アセンブリ:

System.ComponentModel.TypeConverter.dll

指定した属性または属性配列がコレクション内の属性または属性配列と同じかどうかを判断します。

オーバーロード

Matches(Attribute)	指定した属性がコレクション内の属性と同じかどうかを判断します。
Matches(Attribute[])	指定した配列内の属性がコレクション内の属性と同じかどうかを判断します。

Matches(Attribute)

ソース:

AttributeCollection.cs

指定した属性がコレクション内の属性と同じかどうかを判断します。

public:
 bool Matches(Attribute ^ attribute);

public bool Matches (Attribute? attribute);

member this.Matches : Attribute -> bool

Public Function Matches (attribute As Attribute) As Boolean

パラメーター

attribute

Attribute

コレクション内の属性と比較する対象の Attribute のインスタンス。

戻り値

Boolean

指定した属性がコレクションに格納されていて、その値がコレクション内の属性の値と同じ場合は true。それ以外の場合は false。

例

次のコード例では、 が BrowsableAttribute コレクションのメンバーであり、 が に true設定されていることを確認します。 と がbutton1textBox1フォーム上に作成されていることを前提としています。

private:
   void MatchesAttribute()
   {
      // Creates a new collection and assigns it the attributes for button1.
      AttributeCollection^ attributes;
      attributes = TypeDescriptor::GetAttributes( button1 );
      
      // Checks to see if the browsable attribute is true.
      if ( attributes->Matches( BrowsableAttribute::Yes ) )
      {
         textBox1->Text = "button1 is browsable.";
      }
      else
      {
         textBox1->Text = "button1 is not browsable.";
      }
   }

private void MatchesAttribute() {
    // Creates a new collection and assigns it the attributes for button1.
    AttributeCollection attributes;
    attributes = TypeDescriptor.GetAttributes(button1);

    // Checks to see if the browsable attribute is true.
    if (attributes.Matches(BrowsableAttribute.Yes))
       textBox1.Text = "button1 is browsable.";
    else
       textBox1.Text = "button1 is not browsable.";
 }

Private Sub MatchesAttribute
    ' Creates a new collection and assigns it the attributes for button
    Dim attributes As AttributeCollection
    attributes = TypeDescriptor.GetAttributes(button1)

    ' Checks to see if the browsable attribute is true.
    If attributes.Matches(BrowsableAttribute.Yes) Then
        textBox1.Text = "button1 is browsable."
    Else
        textBox1.Text = "button1 is not browsable."
    End If
End Sub

注釈

属性は、照合のサポートを提供できます。

メソッドと メソッドのMatches違いは、 Matches 属性で メソッドをMatch呼び出しContains、 メソッドをEquals呼び出す点Containsです。

ほとんどの属性では、これらのメソッドは同じことを行います。 ただし、複数のフラグを持つ可能性がある属性の場合は、通常、 Match いずれかのフラグが満たされた場合に が返 true されるように実装されます。 たとえば、ブール値フラグ "SupportsSql"、"SupportsOleDb"、"SupportsXml" を持つデータ バインディング属性について考えてみましょう。 この属性は、3 つのデータ バインディング アプローチをすべてサポートするプロパティに存在する場合があります。 多くの場合、プログラマは、3 つすべてではなく、特定のアプローチが利用できる場合にのみ知る必要があります。 したがって、プログラマは、プログラマが必要とするフラグのみを含む 属性のインスタンスで を使用 Match できます。

こちらもご覧ください

• Attribute
• BrowsableAttribute

Matches(Attribute[])

ソース:

AttributeCollection.cs

指定した配列内の属性がコレクション内の属性と同じかどうかを判断します。

public:
 bool Matches(cli::array <Attribute ^> ^ attributes);

public bool Matches (Attribute[]? attributes);

member this.Matches : Attribute[] -> bool

Public Function Matches (attributes As Attribute()) As Boolean

パラメーター

attributes

Attribute[]

コレクション内の属性と比較する対象の MemberAttributes の配列。

戻り値

Boolean

配列内の属性がコレクションに格納されていて、その値がコレクション内の属性の値と同じ場合は true。それ以外の場合は false。

例

次のコード例では、ボタンとテキスト ボックスの属性を比較して、それらが一致するかどうかを確認します。 と がbutton1textBox1フォーム上に作成されていることを前提としています。

private:
   void MatchesAttributes()
   {
      // Creates a new collection and assigns it the attributes for button1.
      AttributeCollection^ myCollection;
      myCollection = TypeDescriptor::GetAttributes( button1 );
      
      // Checks to see whether the attributes in myCollection match the attributes for textBox1.
      array<Attribute^>^ myAttrArray = gcnew array<Attribute^>(100);
      TypeDescriptor::GetAttributes( textBox1 )->CopyTo( myAttrArray, 0 );
      if ( myCollection->Matches( myAttrArray ) )
      {
         textBox1->Text = "The attributes in the button and text box match.";
      }
      else
      {
         textBox1->Text = "The attributes in the button and text box do not match.";
      }
   }

private void MatchesAttributes() {
   // Creates a new collection and assigns it the attributes for button1.
   AttributeCollection myCollection;
   myCollection = TypeDescriptor.GetAttributes(button1);

   // Checks to see whether the attributes in myCollection match the attributes for textBox1.
   Attribute[] myAttrArray = new Attribute[100];
   TypeDescriptor.GetAttributes(textBox1).CopyTo(myAttrArray, 0);
   if (myCollection.Matches(myAttrArray))
      textBox1.Text = "The attributes in the button and text box match.";
   else
      textBox1.Text = "The attributes in the button and text box do not match.";
}

Private Sub MatchesAttributes()
    ' Creates a new collection and assigns it the attributes for button1.
    Dim myCollection As AttributeCollection
    myCollection = TypeDescriptor.GetAttributes(button1)
       
    ' Checks to see whether the attributes in myCollection match the attributes.
    ' for textBox1.
    Dim myAttrArray(100) As Attribute
    TypeDescriptor.GetAttributes(textBox1).CopyTo(myAttrArray, 0)
    If myCollection.Matches(myAttrArray) Then
        textBox1.Text = "The attributes in the button and text box match."
    Else
        textBox1.Text = "The attributes in the button and text box do not match."
    End If
End Sub

注釈

属性は、照合のサポートを提供できます。

こちらもご覧ください

• Attribute