CodeConnectAccess

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

CodeConnectAccess クラス

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

コードに許可されたネットワーク リソース アクセスを指定します。

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

Visual Basic (宣言)

<SerializableAttribute> _
<ComVisibleAttribute(True)> _
Public Class CodeConnectAccess

Visual Basic (使用法)

Dim instance As CodeConnectAccess

C#

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public class CodeConnectAccess

C++

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public ref class CodeConnectAccess

J#

/** @attribute SerializableAttribute() */ 
/** @attribute ComVisibleAttribute(true) */ 
public class CodeConnectAccess

JScript

SerializableAttribute 
ComVisibleAttribute(true) 
public class CodeConnectAccess

解説

このクラスは、実行コードをダウンロード元サイトに接続する方法を制御するために NetCodeGroup クラスと共に使用されます。これらのクラスにより、元のサイトにアクセスする場合に使用可能なスキームおよびポートを管理する、実行コードに与えられた WebPermission をプログラムで制御できます。コードのダウンロード元 URL のスキームに基づいて許可されたスキームおよびポートを指定できます。

コードの元のスキームに基づいて CodeConnectAccess オブジェクトを作成するには、CreateOriginSchemeAccess メソッドを使用します。

すべてのスキームを使用できる (ただし、ポートごとに制約を受ける) CodeConnectAccess オブジェクトを作成するには、CreateAnySchemeAccess メソッドを使用します。

使用例

NetCodeGroup オブジェクトを作成し、そのオブジェクトをユーザー ポリシー レベルに追加するコード例を次に示します。

C#

public static void SetNetCodeGroupAccess()
{
    const string userPolicyLevel = "User";
    // Locate the User policy level.
    PolicyLevel level = null;
    System.Collections.IEnumerator ph = 
        System.Security.SecurityManager.PolicyHierarchy();
    while(ph.MoveNext())
    {
        level = (PolicyLevel)ph.Current;
        if( level.Label == userPolicyLevel )
        {
            break;
        }
    }
    if (level.Label != userPolicyLevel)
        throw new ApplicationException("Could not find User
 policy level.");

    IMembershipCondition membership =
        new UrlMembershipCondition(@"http://www.contoso.com/*");
    NetCodeGroup codeGroup = new NetCodeGroup(membership);
    // Delete default settings.
    codeGroup.ResetConnectAccess();
    // Create an object that represents access to the FTP scheme and
 default port.
    CodeConnectAccess a1 = new CodeConnectAccess(Uri.UriSchemeFtp,
 CodeConnectAccess.DefaultPort);
    // Create an object that represents access to the HTTPS scheme and
 default port.
    CodeConnectAccess a2 = new CodeConnectAccess(Uri.UriSchemeHttps
,
 CodeConnectAccess.DefaultPort);
    // Create an object that represents access to the origin scheme
 and port.
    CodeConnectAccess a3 = CodeConnectAccess.CreateOriginSchemeAccess(CodeConnectAccess.OriginPort);
    // Add connection access objects to the NetCodeGroup object.
    codeGroup.AddConnectAccess(Uri.UriSchemeHttp, a1);
    codeGroup.AddConnectAccess(Uri.UriSchemeHttp, a2);
    codeGroup.AddConnectAccess(Uri.UriSchemeHttp, a3);
    // Provide name and description information for caspol.exe tool.
    codeGroup.Name = "ContosoHttpCodeGroup";
    codeGroup.Description = "Code originating from contoso.com can connect back
 using the FTP or HTTPS.";
    // Add the code group to the User policy's root node.
    level.RootCodeGroup.AddChild(codeGroup);
    // Save the changes to the policy level.
    System.Security.SecurityManager.SavePolicy();
}

C++

static void SetNetCodeGroupAccess()
{
    String^ userPolicyLevel = "User";
    // Locate the User policy level.
    PolicyLevel^ level = nullptr;
    System::Collections::IEnumerator^ ph = 
        System::Security::SecurityManager::PolicyHierarchy();
    while(ph->MoveNext())
    {
        level = (PolicyLevel^)ph->Current;
        if (level->Label == userPolicyLevel)
        {
            break;       
        }
    }
    if (level->Label != userPolicyLevel)
        throw gcnew ApplicationException("Could not find User policy level.");

    IMembershipCondition^ membership =
        gcnew UrlMembershipCondition("http://www.contoso.com/*");
    NetCodeGroup^ codeGroup = gcnew NetCodeGroup(membership);
    // Delete default settings.
    codeGroup->ResetConnectAccess();
    // Create an object that represents access to the FTP scheme and
 
    // default port.
    CodeConnectAccess^ CodeAccessFtp = 
        gcnew CodeConnectAccess(Uri::UriSchemeFtp, 
        CodeConnectAccess::DefaultPort);
    // Create an object that represents access to the HTTPS scheme 
    // and default port.
    CodeConnectAccess^ CodeAccessHttps = 
        gcnew CodeConnectAccess(Uri::UriSchemeHttps, 
        CodeConnectAccess::DefaultPort);
    // Create an object that represents access to the origin 
    // scheme and port.
    CodeConnectAccess^ CodeAccessOrigin = 
        CodeConnectAccess::CreateOriginSchemeAccess
        (CodeConnectAccess::OriginPort);
    // Add connection access objects to the NetCodeGroup object.
    codeGroup->AddConnectAccess(Uri::UriSchemeHttp, CodeAccessFtp);
    codeGroup->AddConnectAccess(Uri::UriSchemeHttp, CodeAccessHttps);
    codeGroup->AddConnectAccess(Uri::UriSchemeHttp, CodeAccessOrigin);
    // Provide name and description information for caspol.exe tool.
    codeGroup->Name = "ContosoHttpCodeGroup";
    codeGroup->Description = "Code originating from contoso.com can"
 +
        " connect back using the FTP or HTTPS.";
    // Add the code group to the User policy's root node.
    level->RootCodeGroup->AddChild(codeGroup);
    // Save the changes to the policy level.
    System::Security::SecurityManager::SavePolicy();
}

J#

public static void SetNetCodeGroupAccess()
 throws ApplicationException
{
    final String userPolicyLevel = "User";
    // Locate the User policy level.
    PolicyLevel level = null;
    System.Collections.IEnumerator ph =
        System.Security.SecurityManager.PolicyHierarchy();
    while (ph.MoveNext()) {
        level = (PolicyLevel)ph.get_Current();
        if (level.get_Label().Equals(userPolicyLevel)) {
            break;
        }
    }
    if (!(level.get_Label().Equals(userPolicyLevel))) {
        throw new ApplicationException("Could not find User
 policy level.");
    }
    IMembershipCondition membership =
        new UrlMembershipCondition("http://www.contoso.com/*");
    NetCodeGroup codeGroup = new NetCodeGroup(membership);
    // Delete default settings.
    codeGroup.ResetConnectAccess();
    // Create an object that represents access to the FTP scheme and
    // default port.
    CodeConnectAccess a1 =
        new CodeConnectAccess(Uri.UriSchemeFtp,
        CodeConnectAccess.DefaultPort);
    // Create an object that represents access to the HTTPS scheme
    // and default port.
    CodeConnectAccess a2 = new CodeConnectAccess(Uri.UriSchemeHttps
,
        CodeConnectAccess.DefaultPort);
    // Create an object that represents access to the origin scheme
 and port.
    CodeConnectAccess a3 = CodeConnectAccess.CreateOriginSchemeAccess(
        CodeConnectAccess.OriginPort);
    // Add connection access objects to the NetCodeGroup object.
    codeGroup.AddConnectAccess(Uri.UriSchemeHttp, a1);
    codeGroup.AddConnectAccess(Uri.UriSchemeHttp, a2);
    codeGroup.AddConnectAccess(Uri.UriSchemeHttp, a3);
    // Provide name and description information for caspol.exe tool.
    codeGroup.set_Name("ContosoHttpCodeGroup");
    codeGroup.set_Description("Code originating from contoso.com can"
        + " connect back using the FTP or HTTPS.");
    // Add the code group to the User policy's root node.
    level.get_RootCodeGroup().AddChild(codeGroup);
    // Save the changes to the policy level.
    System.Security.SecurityManager.SavePolicy();
} //SetNetCodeGroupAccess

継承階層

System.Object
  System.Security.Policy.CodeConnectAccess

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

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

参照

関連項目
CodeConnectAccess メンバ
System.Security.Policy 名前空間

CodeConnectAccess コンストラクタ

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

CodeConnectAccess クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    allowScheme As String, _
    allowPort As Integer _
)

Visual Basic (使用法)

Dim allowScheme As String
Dim allowPort As Integer

Dim instance As New CodeConnectAccess(allowScheme,
 allowPort)

C#

public CodeConnectAccess (
    string allowScheme,
    int allowPort
)

C++

public:
CodeConnectAccess (
    String^ allowScheme, 
    int allowPort
)

J#

public CodeConnectAccess (
    String allowScheme, 
    int allowPort
)

JScript

public function CodeConnectAccess (
    allowScheme : String, 
    allowPort : int
)

パラメータ

allowScheme

現在のインスタンスによって表される URI スキーム。

allowPort

現在のインスタンスによって表されるポート。

例外

例外の種類	条件
ArgumentOutOfRangeException	allowScheme が null 参照 (Visual Basic では Nothing) です。 または allowScheme が空の文字列 ("") です。 または allowScheme には、スキームで許可されていない文字が含まれています。 または allowPort が 0 未満です。 または allowPort が 65,535 より大きい値です。

解説

Scheme プロパティは、allowScheme パラメータを使用して設定されます。スキームは小文字に変換されます。Scheme の値により、実行コードでネットワーク リソースへの接続に使用できるスキームを制御します。

Port プロパティは、allowPort パラメータを使用して設定されます。Port の値により、実行コードでネットワーク リソースへの接続に使用できるポートを制御します。

使用例

次に示すコード例では、ダウンロードされたコードに対して、HTTP プロトコルおよびダウンロード時と同じポートで元のサーバーに接続することを許可する CodeConnectAccess オブジェクトを作成しています。CodeConnectAccess オブジェクトを使用してコード グループを作成し、そのコード グループをポリシー レベルに追加する例については、CodeConnectAccess クラスの概要を参照してください。

C#

    public static CodeConnectAccess CreateHttpAndOriginPortAccess()
{
    return new CodeConnectAccess(Uri.UriSchemeHttp
,
 CodeConnectAccess.OriginPort);
}

C++

static CodeConnectAccess^ CreateHttpAndOriginPortAccess()
{
    return gcnew CodeConnectAccess(Uri::UriSchemeHttp, 
        CodeConnectAccess::OriginPort);
}

J#

public static CodeConnectAccess CreateHttpAndOriginPortAccess()
{
    return new CodeConnectAccess(Uri.UriSchemeHttp
,
        CodeConnectAccess.OriginPort);
} //CreateHttpAndOriginPortAccess

プラットフォーム

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

参照

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

CodeConnectAccess フィールド

パブリック フィールド

	名前	説明
	AnyScheme	スキーム ワイルドカードを表す文字列値を含んでいます。
	DefaultPort	既定のポートを表すために使用される値を含んでいます。
	OriginPort	コードのダウンロード元 URI のポート値を表すために使用される値を含んでいます。
	OriginScheme	コードのダウンロード元 URL のスキームを表すために使用される値を含んでいます。

参照

関連項目

CodeConnectAccess クラス
System.Security.Policy 名前空間

CodeConnectAccess プロパティ

パブリック プロパティ

	名前	説明
	Port	現在のインスタンスによって表されるポートを取得します。
	Scheme	現在のインスタンスによって表される URI スキームを取得します。

参照

関連項目

CodeConnectAccess クラス
System.Security.Policy 名前空間

CodeConnectAccess メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	CreateAnySchemeAccess	任意のスキームを使用して指定されたポートへのアクセスを表す CodeConnectAccess インスタンスを返します。
	CreateOriginSchemeAccess	コードの元のスキームを使用して指定されたポートへのアクセスを表す CodeConnectAccess インスタンスを返します。
	Equals	オーバーロードされます。 オーバーライドされます。
	GetHashCode	オーバーライドされます。
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

CodeConnectAccess クラス
System.Security.Policy 名前空間

CodeConnectAccess メンバ

コードに許可されたネットワーク リソース アクセスを指定します。

CodeConnectAccess データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	CodeConnectAccess	CodeConnectAccess クラスの新しいインスタンスを初期化します。

パブリック フィールド

	名前	説明
	AnyScheme	スキーム ワイルドカードを表す文字列値を含んでいます。
	DefaultPort	既定のポートを表すために使用される値を含んでいます。
	OriginPort	コードのダウンロード元 URI のポート値を表すために使用される値を含んでいます。
	OriginScheme	コードのダウンロード元 URL のスキームを表すために使用される値を含んでいます。

パブリック プロパティ

	名前	説明
	Port	現在のインスタンスによって表されるポートを取得します。
	Scheme	現在のインスタンスによって表される URI スキームを取得します。

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	CreateAnySchemeAccess	任意のスキームを使用して指定されたポートへのアクセスを表す CodeConnectAccess インスタンスを返します。
	CreateOriginSchemeAccess	コードの元のスキームを使用して指定されたポートへのアクセスを表す CodeConnectAccess インスタンスを返します。
	Equals	オーバーロードされます。 オーバーライドされます。
	GetHashCode	オーバーライドされます。
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

CodeConnectAccess クラス
System.Security.Policy 名前空間