CodeConnectAccess CodeConnectAccess CodeConnectAccess CodeConnectAccess Class

Definition

Gibt den Zugriff auf Netzwerkressourcen an, der Code gewährt wird.Specifies the network resource access that is granted to code.

public ref class CodeConnectAccess
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public class CodeConnectAccess
type CodeConnectAccess = class
Public Class CodeConnectAccess
Vererbung
CodeConnectAccessCodeConnectAccessCodeConnectAccessCodeConnectAccess
Attribute

Beispiele

Im folgenden Codebeispiel wird ein NetCodeGroup -Objekt erstellt und der Benutzerrichtlinien Ebene hinzugefügt.The following code example creates a NetCodeGroup object and adds it to the User policy level.


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();
}
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();
}

Hinweise

Diese Klasse wird in Verbindung mit der NetCodeGroup -Klasse verwendet, um zu steuern, wie die Codeausführung eine Verbindung mit der Website herstellen kann, von der Sie heruntergeladen wurde.This class is used in conjunction with the NetCodeGroup class to control how executing code can connect back to the site it was downloaded from. Diese Klassen bieten programmgesteuerte Kontrolle über WebPermission den gewährten Code, der steuert, welche Schemas und Ports der Code für den Zugriff auf seine Ursprungs Site verwenden kann.These classes provide programmatic control of the WebPermission granted to executing code that controls what schemes and ports the code can use access its origin site. Sie können basierend auf dem Schema in der URL, aus der der Code stammt, Schema-und Port Paare angeben, die zulässig sind.You can specify scheme and port pairs that are permitted based on the scheme in the URL where the code originates.

Verwenden Sie die CodeConnectAccess CreateOriginSchemeAccess -Methode, um ein-Objekt zu erstellen, das auf dem Ursprungs Schema des Codes basiert.To create a CodeConnectAccess object based on the code's origin scheme, use the CreateOriginSchemeAccess method.

Verwenden Sie die CodeConnectAccess -Methode, um ein-Objekt zu erstellen, das jedes beliebige Schema CreateAnySchemeAccess verwenden kann, aber durch den Port eingeschränkt ist.To create a CodeConnectAccess object that can use any scheme but is restricted by port, use the CreateAnySchemeAccess method.

Konstruktoren

CodeConnectAccess(String, Int32) CodeConnectAccess(String, Int32) CodeConnectAccess(String, Int32) CodeConnectAccess(String, Int32)

Initialisiert eine neue Instanz der CodeConnectAccess-Klasse.Initializes a new instance of the CodeConnectAccess class.

Felder

AnyScheme AnyScheme AnyScheme AnyScheme

Enthält den Zeichenfolgenwert, der den Schemaplatzhalter darstellt.Contains the string value that represents the scheme wildcard.

DefaultPort DefaultPort DefaultPort DefaultPort

Enthält den Wert, der zum Darstellen des Standardports verwendet wird.Contains the value used to represent the default port.

OriginPort OriginPort OriginPort OriginPort

Enthält den Wert, der zum Darstellen des Portwerts im URI verwendet wird, von dem der Code stammt.Contains the value used to represent the port value in the URI where code originated.

OriginScheme OriginScheme OriginScheme OriginScheme

Enthält den Wert, der zum Darstellen des Schemas in der URL verwendet wird, von der der Code stammt.Contains the value used to represent the scheme in the URL where the code originated.

Eigenschaften

Port Port Port Port

Ruft den durch die aktuelle Instanz dargestellten Port ab.Gets the port represented by the current instance.

Scheme Scheme Scheme Scheme

Ruft das durch die aktuelle Instanz dargestellte URI-Schema ab.Gets the URI scheme represented by the current instance.

Methoden

CreateAnySchemeAccess(Int32) CreateAnySchemeAccess(Int32) CreateAnySchemeAccess(Int32) CreateAnySchemeAccess(Int32)

Gibt eine CodeConnectAccess-Instanz zurück, die Zugriff auf den angegebenen Port mit einem beliebigen Schema darstellt.Returns a CodeConnectAccess instance that represents access to the specified port using any scheme.

CreateOriginSchemeAccess(Int32) CreateOriginSchemeAccess(Int32) CreateOriginSchemeAccess(Int32) CreateOriginSchemeAccess(Int32)

Gibt eine CodeConnectAccess-Instanz zurück, die Zugriff auf den angegebenen Port mit dem Ursprungsschema des Codes darstellt.Returns a CodeConnectAccess instance that represents access to the specified port using the code's scheme of origin.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Gibt einen Wert zurück, der angibt, ob zwei CodeConnectAccess-Objekte dasselbe Schema und denselben Port darstellen.Returns a value indicating whether two CodeConnectAccess objects represent the same scheme and port.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Hashfunktion für einen besonderen Typ.Serves as a hash function for a particular type.

GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Gilt für: