WebPermission.IsSubsetOf メソッドとは何？わかりやすく解説 Weblio辞書

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

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

WebPermission.IsSubsetOf メソッド

現在の WebPermission が、指定したオブジェクトのサブセットかどうかを判断します。

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

Visual Basic (宣言)

Public Overrides Function
 IsSubsetOf ( _
    target As IPermission _
) As Boolean

Visual Basic (使用法)

Dim instance As WebPermission
Dim target As IPermission
Dim returnValue As Boolean

returnValue = instance.IsSubsetOf(target)

public override bool IsSubsetOf (
    IPermission target
)

C++

public:
virtual bool IsSubsetOf (
    IPermission^ target
) override

public boolean IsSubsetOf (
    IPermission target
)

JScript

public override function IsSubsetOf (
    target : IPermission
) : boolean

パラメータ

target: 現在の WebPermission と比較する WebPermission。

戻り値
現在のインスタンスが target パラメータのサブセットである場合は true。それ以外の場合は false。ターゲットが null 参照 (Visual Basic では Nothing) の場合は、メソッドは無制限ではない現在の空のアクセス許可に対して true を返します。それ以外の場合は false を返します。

例外

例外の種類	条件
ArgumentException	指定するパラメータが、WebPermission のインスタンスではありません。
NotSupportedException	現在のインスタンスに Regex エンコードされた権利が格納されていて、指定するインスタンスには同じ権利がない場合。

解説

現在の WebPermission が、関連付けられたリソースセットを指定し、そのセット全体が target パラメータによって格納される場合は、現在の WebPermission が target のサブセットになります。このメソッドは、IsSubsetOf をオーバーライドし、IPermission インターフェイスをサポートするために実装されます。

使用例

IsSubsetOf を使用して、WebPermission の 1 つのインスタンスにあるアクセス権が、WebPermission の別のインスタンスにあるかどうかを判断する例を次に示します。

Visual Basic

   ' Create the target permission.
   Dim targetPermission As New
 WebPermission()
   targetPermission.AddPermission(NetworkAccess.Connect, New Regex("www\.contoso\.com/Public/.*"))
   
   ' Create the permission for a URI matching target.
   Dim connectPermission As New
 WebPermission()
   connectPermission.AddPermission(NetworkAccess.Connect, "www.contoso.com/Public/default.htm")
   
   'The following statement prints true.
   Console.WriteLine(("Is the second URI a subset of the first
 one?: " & connectPermission.IsSubsetOf(targetPermission)))
End Sub 'myIsSubsetExample

// Create the target permission.
WebPermission targetPermission = new WebPermission();
targetPermission.AddPermission(NetworkAccess.Connect, new Regex("www\\.contoso\\.com/Public/.*"));

// Create the permission for a URI matching target.
WebPermission connectPermission = new WebPermission();
connectPermission.AddPermission(NetworkAccess.Connect, "www.contoso.com/Public/default.htm");

//The following statement prints true.
Console.WriteLine("Is the second URI a subset of the first one?: " + connectPermission.IsSubsetOf(targetPermission));

C++

// Create the target permission.
WebPermission^ targetPermission = gcnew WebPermission;
targetPermission->AddPermission( NetworkAccess::Connect, gcnew Regex( "www\\.contoso\\.com/Public/.*"
 ) );

// Create the permission for a URI matching target.
WebPermission^ connectPermission = gcnew WebPermission;
connectPermission->AddPermission( NetworkAccess::Connect, "www.contoso.com/Public/default.htm"
 );

//The following statement prints true.
Console::WriteLine( "Is the second URI a subset of the first one?: {0}",
 connectPermission->IsSubsetOf( targetPermission ) );

// Create the target permission.
WebPermission targetPermission = new WebPermission();
targetPermission.AddPermission(NetworkAccess.Connect,
    new Regex("www\\.contoso\\.com/Public/.*"));
// Create the permission for a URI matching target.
WebPermission connectPermission = new WebPermission();
connectPermission.AddPermission(NetworkAccess.Connect, 
    "www.contoso.com/Public/default.htm");
//The following statement prints true.
Console.WriteLine("Is the second URI a subset of the first one?: " 
    + (System.Boolean)connectPermission.IsSubsetOf(targetPermission));