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

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

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

FilterableAttribute クラス

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

属性を適用するプロパティでデバイスのフィルタ処理をサポートするかどうかを指定します。このクラスは継承できません。

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

Visual Basic (宣言)

<AttributeUsageAttribute(AttributeTargets.Class Or AttributeTargets.Property)>
 _
Public NotInheritable Class
 FilterableAttribute
    Inherits Attribute

Visual Basic (使用法)

Dim instance As FilterableAttribute

[AttributeUsageAttribute(AttributeTargets.Class|AttributeTargets.Property)] 
public sealed class FilterableAttribute : Attribute

C++

[AttributeUsageAttribute(AttributeTargets::Class|AttributeTargets::Property)] 
public ref class FilterableAttribute sealed
 : public Attribute

/** @attribute AttributeUsageAttribute(AttributeTargets.Class|AttributeTargets.Property)
 */ 
public final class FilterableAttribute extends
 Attribute

JScript

AttributeUsageAttribute(AttributeTargets.Class|AttributeTargets.Property) 
public final class FilterableAttribute extends
 Attribute

解説

FilterableAttribute 属性をプロパティに適用し、プロパティでデバイスのフィルタ処理をサポートするかどうかを指定します。プロパティでデバイスのフィルタ処理がサポートされている場合は、デバイスフィルタを指定することで、特定のデバイスのプロパティの値をオーバーライドできます。既定ではプロパティはフィルタ処理できるように設定されています。コントロールの開発者は、FilterableAttribute 属性を false に設定することで、プロパティでデバイスのフィルタ処理を回避できます。詳細については、「特定のデバイス用のカスタマイズ」を参照してください。

属性の使用方法については、「属性を使用したメタデータの拡張」を参照してください。

FilterableAttribute クラスのインスタンスの初期プロパティ値の一覧については、FilterableAttribute コンストラクタのトピックを参照してください。

使用例

FilterableAttribute 属性をカスタムコントロールのプロパティに適用して、プロパティでデバイスのフィルタ処理がサポートされていないことを示す方法を次のコード例に示します。

Visual Basic

Imports System.ComponentModel
Imports System.Web.UI

Namespace Samples.AspNet.VB.Controls

    Public Class SimpleCustomControl
        Inherits System.Web.UI.WebControls.WebControl

        Dim _productID As String

        ' Set Filterable attribute to specify that this
        ' property does not support device filtering.
        <Bindable(True), Filterable(False)>
 Property ProductID() As String
            Get
                Return _productID
            End Get

            Set(ByVal Value As
 String)
                _productID = Value
            End Set
        End Property
    End Class

End Namespace

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Text;
using System.Web.UI;
using System.Web.UI.WebControls;

namespace Samples.AspNet.CS.Controls
{
    public class SimpleCustomControl : WebControl
    {
        private string _productID;

        // Set Filterable attribute to specify that this
        // property does not support device filtering.
        [Bindable(true)]
        [Filterable(false)]
        public string ProductID
        {
            get
            {
                return _productID;
            }
            set
            {
                _productID = value;
            }
        }
    }
}