StrongNameIdentityPermission.Union メソッド

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

StrongNameIdentityPermission.Union メソッド

現在のアクセス許可と指定したアクセス許可の和集合を表すアクセス許可を作成します。

名前空間: System.Security.Permissions
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Overrides Function
 Union ( _
    target As IPermission _
) As IPermission

Visual Basic (使用法)

Dim instance As StrongNameIdentityPermission
Dim target As IPermission
Dim returnValue As IPermission

returnValue = instance.Union(target)

C#

public override IPermission Union (
    IPermission target
)

C++

public:
virtual IPermission^ Union (
    IPermission^ target
) override

J#

public IPermission Union (
    IPermission target
)

JScript

public override function Union (
    target : IPermission
) : IPermission

パラメータ

target

現在のアクセス許可と和集合を持つアクセス許可。これは、現在のアクセス許可と同じ型であることが必要です。

戻り値
現在のアクセス許可と指定したアクセス許可の和集合を表す新しいアクセス許可。

例外

例外の種類	条件
ArgumentException	target パラメータが null 参照 (Visual Basic では Nothing) ではなく、現在のアクセス許可と同じ型でもありません。 または アクセス許可は同一ではありません。互いのサブセットでもありません。

解説

Union を呼び出すと、現在のアクセス許可と指定したアクセス許可の両方が表す操作をすべて表すアクセス許可が作成されます。いずれかのアクセス許可を要求し、その要求が満たされた場合、両者の和集合を表すアクセス許可に対する要求も満たされます。

アクセス許可と null 参照 (Visual Basic では Nothing) の和集合では、アクセス許可は null 参照 (Visual Basic では Nothing) にはなりません。アクセス許可とそのアクセス許可のサブセットの和集合では、アクセス許可に残りの部分が含まれます。その他の組み合わせでは、ArgumentException 例外がスローされます。

使用例

次に示すのは、Union メソッドを使用した場合の結果を示すコード例です (メソッドの使用方法を示すものではありません)。このコード例は、StrongNameIdentityPermission クラスのトピックで取り上げているコード例の一部分です。よりよく理解するためには、コード全体を記述して実行し、その出力を確認することをお勧めします。

Visual Basic

' Union creates a new permission that is the union of the current permission
 and the specified permission.
Private Function UnionDemo() As
 Boolean 
    
    Dim returnValue As Boolean
 = True
    
    Dim snIdPerm1, snIdPerm2 As StrongNameIdentityPermission
    Dim snIdPerm3 As IPermission
    
    snIdPerm1 = New StrongNameIdentityPermission(blob, "MyCompany.MyDepartment.*",
 New Version("1.0.0.0"))
    snIdPerm2 = New StrongNameIdentityPermission(blob, "MyCompany.MyDepartment.MyFile",
 New Version("1.0.0.0"))
    
    snIdPerm3 = CType(snIdPerm1.Union(snIdPerm2), StrongNameIdentityPermission)
    
    Try
        Console.WriteLine("The union of MyCompany.MyDepartment.*"
 + "and MyCompany.MyDepartment.MyFile is " + CType(snIdPerm3,
 StrongNameIdentityPermission).Name.ToString())
    Catch e As Exception
        Console.WriteLine("An expected exception was thrown: "
 + e.Message)
    End Try
    
    
    Return returnValue

End Function 'UnionDemo
 

C#

// Union creates a new permission that is the union of the current permission
 and the specified permission.
private bool UnionDemo()
{

    bool returnValue = true;

    StrongNameIdentityPermission snIdPerm1, snIdPerm2;
    IPermission snIdPerm3;

    snIdPerm1 = new StrongNameIdentityPermission(blob, "MyCompany.MyDepartment.*",
 new Version("1.0.0.0"));
    snIdPerm2 = new StrongNameIdentityPermission(blob, "MyCompany.MyDepartment.MyFile",
 new Version("1.0.0.0"));

    snIdPerm3 = (StrongNameIdentityPermission)snIdPerm1.Union(snIdPerm2);

    try
    {
        Console.WriteLine("The union of MyCompany.MyDepartment.*" +
        "and MyCompany.MyDepartment.MyFile is " +
        ((StrongNameIdentityPermission)snIdPerm3).Name.ToString());
    }
    catch (Exception e)
    {
        Console.WriteLine("An expected exception was thrown: " + e.Message);
    }


    return returnValue;

}

C++

// Union creates a new permission that is the union of the current permission
 and the specified permission.
bool UnionDemo()
{
    bool returnValue = true;
    StrongNameIdentityPermission^ snIdPerm1;
    StrongNameIdentityPermission^ snIdPerm2;
    IPermission^ snIdPerm3;
    snIdPerm1 = gcnew StrongNameIdentityPermission(blob, "MyCompany.MyDepartment.*",
 gcnew Version("1.0.0.0"));
    snIdPerm2 = gcnew StrongNameIdentityPermission(blob, "MyCompany.MyDepartment.MyFile",
 gcnew Version("1.0.0.0"));
    snIdPerm3 = dynamic_cast<StrongNameIdentityPermission^>(snIdPerm1->Union(
 snIdPerm2 ));
    snIdPerm3 = snIdPerm1->Union( snIdPerm2 );

    try
    {
        Console::WriteLine("The union of MyCompany.MyDepartment.*" +
            "and MyCompany.MyDepartment.MyFile is " +
            (dynamic_cast<StrongNameIdentityPermission^>(snIdPerm3))->Name);
 
    }
    catch (Exception^ e)
    {
        Console::WriteLine("An expected exception was thrown: " + e->Message);
    }


    return returnValue;
}

プラットフォーム

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
StrongNameIdentityPermission クラス
StrongNameIdentityPermission メンバ
System.Security.Permissions 名前空間