IPermission.IsSubsetOf メソッド
アセンブリ: mscorlib (mscorlib.dll 内)
構文Dim instance As IPermission Dim target As IPermission Dim returnValue As Boolean returnValue = instance.IsSubsetOf(target)
戻り値
現在のアクセス許可が、指定したアクセス許可のサブセットである場合は true。それ以外の場合は false。
例外
解説現在のアクセス許可で指定される操作の集合が、指定したアクセス許可に完全に含まれる場合、現在のアクセス許可オブジェクトは指定したアクセス許可オブジェクトのサブセットです。たとえば、C:\example.txt へのアクセス権を表すアクセス許可は、C:\ へのアクセス権を表すアクセス許可のサブセットです。このメソッドが true を返す場合、現在のアクセス許可が保護されたリソースに対して表すアクセス権は、指定したアクセス許可が表すアクセス権と同じか、またはそのサブセットです
IsSubsetOf メソッドのすべての実装で、次に示すステートメントは true である必要があります。X、Y、および Z は、null 参照 (Visual Basic では Nothing) 以外の IPermission オブジェクトを表します。
-
X と Y が同じアクセス許可のセットを表している場合に限り、X .IsSubsetOf( Y ) は、Y .IsSubsetOf( X ) と同じ値を返します。
-
X .IsSubsetOf( Y ) と Y .IsSubsetOf( Z ) がどちらも true を返す場合、X .IsSubsetOf( Z ) は、true を返します。
X がアクセス状態 None の空の IPermission オブジェクトを表し、Y が null 参照 (Visual Basic では Nothing) の IPermission オブジェクトを表すとすると、X.IsSubsetOf(Y) は true を返します。Z も空のアクセス許可である場合、複合セット操作 X.Union(Z).IsSubsetOf(Y) も true を返します。2 つの空のアクセス許可の結合は、空のアクセス許可であるためです。
使用例IsSubsetOf メソッドを実装する方法を次のコード例に示します。このコード例は、IPermission クラスのトピックで取り上げているコード例の一部分です。
// Called by the Demand method: returns true if 'this' is a subset of 'target'. public override Boolean IsSubsetOf(IPermission target) { // If 'target' is null and this permission allows nothing, return true. if (target == null) return m_flags == 0; // Both objects must be the same type. SoundPermission soundPerm = VerifyTypeMatch(target); // Return true if the permissions of 'this' is a subset of 'target'. return m_flags <= soundPerm.m_flags; }
// Called by the Demand method: returns true // if 'this' is a subset of 'target'. public: virtual bool IsSubsetOf(IPermission^ target) override { // If 'target' is null and this permission allows nothing, // return true. if (target == nullptr) { return (int)stateFlags == 0; } // Both objects must be the same type. SoundPermission^ soundPerm = VerifyTypeMatch(target); // Return true if the permissions of 'this' // is a subset of 'target'. return stateFlags <= soundPerm->stateFlags; }
プラットフォーム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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報
参照- IPermission.IsSubsetOf メソッドのページへのリンク