WebPermission Klasse
TOC
Inhaltsverzeichnis reduzieren
Inhaltsverzeichnis erweitern
Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

WebPermission-Klasse

 

Steuert die Zugriffsrechte für den Zugriff auf HTTP-Internetressourcen.

Namespace:   System.Net
Assembly:  System (in System.dll)


[SerializableAttribute]
public sealed class WebPermission : CodeAccessPermission, IUnrestrictedPermission

NameBeschreibung
System_CAPS_pubmethodWebPermission()

Erstellt eine neue Instanz der WebPermission-Klasse.

System_CAPS_pubmethodWebPermission(NetworkAccess, Regex)

Initialisiert eine neue Instanz der WebPermission-Klasse mit den angegebenen Zugriffsrechten für den angegebenen regulären URI-Ausdruck.

System_CAPS_pubmethodWebPermission(NetworkAccess, String)

Initialisiert eine neue Instanz der WebPermission-Klasse mit den angegebenen Zugriffsrechten für den angegebenen URI.

System_CAPS_pubmethodWebPermission(PermissionState)

Erstellt eine neue Instanz der WebPermission-Klasse, die alle Anforderungen entweder übergibt oder ablehnt.

NameBeschreibung
System_CAPS_pubpropertyAcceptList

Diese Eigenschaft gibt eine Enumeration einer einzelnen Akzeptierungsberechtigung zurück, die in dieser WebPermission enthalten ist.Mögliche, in der zurückgegebenen Enumeration enthaltene Objekttypen sind String und System.Text.RegularExpressions.Regex.

System_CAPS_pubpropertyConnectList

Diese Eigenschaft gibt eine Enumeration einer einzelnen Verbindungsberechtigung zurück, die in dieser WebPermission enthalten ist.Mögliche, in der zurückgegebenen Enumeration enthaltene Objekttypen sind String und System.Text.RegularExpressions.Regex.

NameBeschreibung
System_CAPS_pubmethodAddPermission(NetworkAccess, Regex)

Fügt der aktuellen WebPermission den angegebenen URI mit den angegebenen Zugriffsrechten hinzu.

System_CAPS_pubmethodAddPermission(NetworkAccess, String)

Fügt der aktuellen WebPermission die angegebene URI-Zeichenfolge mit den angegebenen Zugriffsrechten hinzu.

System_CAPS_pubmethodAssert()

Deklariert, dass der aufrufende Code selbst dann auf die durch eine Berechtigungsanforderung geschützte Ressource über den diese Methode aufrufenden Code zugreifen kann, wenn übergeordnete Aufrufer in der Aufrufliste keine Zugriffsberechtigung für die Ressource besitzen.Die Verwendung von Assert kann zu Sicherheitsproblemen führen.(Geerbt von CodeAccessPermission.)

System_CAPS_pubmethodCopy()

Erstellt eine Kopie einer WebPermission.(Setzt "CodeAccessPermission.Copy()" außer Kraft.)

System_CAPS_pubmethodDemand()

Erzwingt zur Laufzeit eine SecurityException, wenn die von der aktuellen Instanz angegebene Berechtigung keinem übergeordneten Aufrufer in der Aufrufliste gewährt wurde.(Geerbt von CodeAccessPermission.)

System_CAPS_pubmethodDeny()

Veraltet.Verhindert, dass übergeordnete Aufrufer in der Aufrufliste auf die von der aktuellen Instanz angegebene Ressource über Code zugreifen, der diese Methode aufruft.(Geerbt von CodeAccessPermission.)

System_CAPS_pubmethodEquals(Object)

Bestimmt, ob das angegebene CodeAccessPermission-Objekt und das aktuelle CodeAccessPermission-Objekt gleich sind.(Geerbt von CodeAccessPermission.)

System_CAPS_pubmethodFromXml(SecurityElement)

Rekonstruiert eine WebPermission aus einer XML-Codierung.(Setzt "CodeAccessPermission.FromXml(SecurityElement)" außer Kraft.)

System_CAPS_pubmethodGetHashCode()

Ruft einen Hashcode für das CodeAccessPermission-Objekt ab, das für die Verwendung in Hashalgorithmen und Datenstrukturen wie Hashtabellen geeignet ist.(Geerbt von CodeAccessPermission.)

System_CAPS_pubmethodGetType()

Ruft den Type der aktuellen Instanz ab.(Geerbt von Object.)

System_CAPS_pubmethodIntersect(IPermission)

Gibt die logische Schnittmenge zweier WebPermission-Instanzen zurück.(Setzt "CodeAccessPermission.Intersect(IPermission)" außer Kraft.)

System_CAPS_pubmethodIsSubsetOf(IPermission)

Bestimmt, ob die aktuelle WebPermission eine Teilmenge des angegebenen Objekts ist.(Setzt "CodeAccessPermission.IsSubsetOf(IPermission)" außer Kraft.)

System_CAPS_pubmethodIsUnrestricted()

Überprüft den allgemeinen Berechtigungszustand der WebPermission.

System_CAPS_pubmethodPermitOnly()

Verhindert, dass übergeordnete Aufrufer in der Aufrufliste auf alle außer der von der aktuellen Instanz angegebenen Ressource über den Code zugreifen, der diese Methode aufruft.(Geerbt von CodeAccessPermission.)

System_CAPS_pubmethodToString()

Erstellt eine Zeichenfolgenentsprechung des aktuellen Berechtigungsobjekts und gibt diese zurück.(Geerbt von CodeAccessPermission.)

System_CAPS_pubmethodToXml()

Erstellt eine XML-Codierung einer WebPermission und ihres aktuellen Zustands.(Setzt "CodeAccessPermission.ToXml()" außer Kraft.)

System_CAPS_pubmethodUnion(IPermission)

Gibt die logische Gesamtmenge zweier Instanzen der WebPermission-Klasse zurück.(Setzt "CodeAccessPermission.Union(IPermission)" außer Kraft.)

WebPermission stellt für die Steuerung des Zugriffs auf Internetressourcen einen Satz von Methoden und Eigenschaften bereit.Mit einer WebPermission können Sie, je nach dem bei der Erstellung der WebPermission festgelegten PermissionState, beschränkten oder unbeschränkten Zugriff auf die Ressource bereitstellen.

Erstellen Sie eine WebPermission-Instanz, indem Sie ihren Konstruktor mithilfe eines der folgenden Parametersätze aufrufen:

Die ConnectList und AcceptList enthalten die URIs, für die Sie Zugriffsberechtigung erteilt haben.Verwenden Sie AddPermission, um einer der beiden Listen einen URI hinzuzufügen.Wenn Sie Accept als den NetworkAccess-Parameter übergeben, wird der URI der AcceptList hinzugefügt. WebPermission lässt Verbindungen zu der Zielklasse mit URIs zu, die mit der AcceptList übereinstimmen.

System_CAPS_cautionAchtung

Um Zugriff an eine Internetressource zu verweigern, müssen Sie Zugriff auf alle möglichen Pfaden auf diese Ressource verweigern.Dies erfordert das Aufrufen von WebPermission.WebPermission mit den Zustandsparameter, der auf Deny festgelegt ist.Es ist jedoch vorteilhafter, den Zugriff nur auf die bestimmte Ressource zu beschränken.Weitere Informationen über diese Vorgehensweise finden Sie unter dem Thema NIB: Using the Deny Method.

System_CAPS_noteHinweis

Sie müssen Zugriff nur mithilfe des Pfades kanonischen der Ressource verweigern.Es ist nicht erforderlich, alle syntaktischen Variationen für den Pfad zu verwenden.

System_CAPS_noteHinweis

Benutzername und Standardanschlussinformationen werden aus dem Uri entfernt, bevor der Vergleich mit dem vom WebPermission(NetworkAccess, Regex)-Konstruktor bereitgestellten regulären Ausdrucksargument ausgeführt wird.Wenn der reguläre Ausdruck Benutzerinformationen oder die Standardanschlussnummer enthält, stimmt keiner der Uri mit dem regulären Ausdruck überein.

Im folgenden Beispiel wird veranschaulicht, wie eine neue Instanz von WebPermission mithilfe von Regex erstellt wird.Weitere Hosts werden der WebPermission-Liste für das Verbinden und Akzeptieren hinzugefügt.Schließlich wird die Liste für das Verbinden und Akzeptieren auf der Konsole angezeigt.


//  Create a Regex that accepts all URLs containing the host fragment www.contoso.com.
Regex myRegex = new Regex(@"http://www\.contoso\.com/.*");

// Create a WebPermission that gives permissions to all the hosts containing the same host fragment.
WebPermission myWebPermission = new WebPermission(NetworkAccess.Connect,myRegex);

//Add connect privileges for a www.adventure-works.com.
myWebPermission.AddPermission(NetworkAccess.Connect,"http://www.adventure-works.com");

//Add accept privileges for www.alpineskihouse.com.
myWebPermission.AddPermission(NetworkAccess.Accept, "http://www.alpineskihouse.com/");

// Check whether all callers higher in the call stack have been granted the permission.
myWebPermission.Demand();

// Get all the URIs with Connect permission.
IEnumerator myConnectEnum = myWebPermission.ConnectList;
Console.WriteLine("\nThe 'URIs' with 'Connect' permission are :\n");
while (myConnectEnum.MoveNext())
{Console.WriteLine("\t" + myConnectEnum.Current);}

// Get all the URIs with Accept permission.	  
IEnumerator myAcceptEnum = myWebPermission.AcceptList;
Console.WriteLine("\n\nThe 'URIs' with 'Accept' permission is :\n");

while (myAcceptEnum.MoveNext())
  {Console.WriteLine("\t" + myAcceptEnum.Current);}

.NET Framework
Verfügbar seit 1.1

Öffentliche statische (in Visual Basic freigegebene) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Zurück zum Anfang
Anzeigen:
© 2016 Microsoft