WebPermission Klass
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Styr behörighet att komma åt HTTP Internet-resurser.
public ref class WebPermission sealed : System::Security::CodeAccessPermission, System::Security::Permissions::IUnrestrictedPermission
[System.Serializable]
public sealed class WebPermission : System.Security.CodeAccessPermission, System.Security.Permissions.IUnrestrictedPermission
[<System.Serializable>]
type WebPermission = class
inherit CodeAccessPermission
interface IUnrestrictedPermission
Public NotInheritable Class WebPermission
Inherits CodeAccessPermission
Implements IUnrestrictedPermission
- Arv
- Attribut
- Implementeringar
Kommentarer
Caution
Code Access Security (CAS) har föråldrats i alla versioner av .NET Framework och .NET. De senaste versionerna av .NET följer inte CAS-anteckningar och skapar fel om CAS-relaterade API:er används. Utvecklare bör söka alternativa sätt att utföra säkerhetsuppgifter.
WebPermission innehåller en uppsättning metoder och egenskaper för att styra åtkomsten till Internetresurser. Du kan använda en WebPermission för att ge antingen begränsad eller obegränsad åtkomst till din resurs, baserat på den PermissionState som anges när WebPermission den skapas.
Skapa en WebPermission instans genom att anropa konstruktorn med någon av följande uppsättningar parametrar:
Inga parametrar. Standardvärdet PermissionState är None.
En PermissionState. Ange antingen Unrestricted för att tillåta att någon URI används i målklassen eller None för att endast tillåta åtkomst till URI:er som du anger med hjälp av AddPermission metoden.
Ett NetworkAccess värde och en URI-sträng. Den angivna URI:n har behörigheter som beviljats av NetworkAccess värdet.
Ett NetworkAccess reguljärt uttryck för specificerare och URI.
Och ConnectListAcceptList innehåller de URI:er som du har beviljat åtkomstbehörighet till. Om du vill lägga till en URI i någon av dessa listor använder du AddPermission. Om du skickar Accept som NetworkAccess parameter läggs URI:n till i AcceptList. WebPermission tillåter anslutningar till målklassen med URI:er som AcceptListmatchar .
Caution
Om du vill neka åtkomst till en Internetresurs måste du neka åtkomst till alla möjliga sökvägar till resursen. Detta kräver anrop WebPermission.WebPermission med tillståndsparametern inställd på Deny. En bättre metod är att endast tillåta åtkomst till den specifika resursen. Mer information om det här ämnet finns i avsnittet Använda metoden Neka .
Note
Du behöver bara neka åtkomst med hjälp av resursens kanoniska sökväg. Du behöver inte använda alla sökvägens syntaktiska variationer.
Note
Användarnamn och standardportinformation tas bort från Uri före jämförelsen med det reguljära uttrycksargument som tillhandahålls konstruktorn WebPermission(NetworkAccess, Regex) . Om det reguljära uttrycket innehåller användarinformation eller standardportnumret kommer alla inkommande Uris inte att matcha det reguljära uttrycket.
Konstruktorer
| Name | Description |
|---|---|
| WebPermission() |
Skapar en ny instans av WebPermission klassen. |
| WebPermission(NetworkAccess, Regex) |
Initierar en ny instans av WebPermission klassen med de angivna åtkomsträttigheterna för det angivna reguljära URI-uttrycket. |
| WebPermission(NetworkAccess, String) |
Initierar en ny instans av WebPermission klassen med de angivna åtkomsträttigheterna för den angivna URI:n. |
| WebPermission(PermissionState) |
Skapar en ny instans av WebPermission klassen som klarar alla krav eller misslyckas med alla krav. |
Egenskaper
| Name | Description |
|---|---|
| AcceptList |
Den här egenskapen returnerar en uppräkning av en enda acceptbehörighet som innehas av den här WebPermission. Möjliga objekttyper som finns i den returnerade uppräkningen är String och Regex. |
| ConnectList |
Den här egenskapen returnerar en uppräkning av en enda anslutningsbehörighet som innehas av den här WebPermission. Möjliga objekttyper som finns i den returnerade uppräkningen är String och Regex. |
Metoder
| Name | Description |
|---|---|
| AddPermission(NetworkAccess, Regex) |
Lägger till den angivna URI:n med de angivna åtkomsträttigheterna till den aktuella WebPermission. |
| AddPermission(NetworkAccess, String) |
Lägger till den angivna URI-strängen med de angivna åtkomsträttigheterna till den aktuella WebPermission. |
| Assert() |
Deklarerar att den anropande koden kan komma åt resursen som skyddas av ett behörighetskrav via koden som anropar den här metoden, även om anropare högre i stacken inte har beviljats behörighet att komma åt resursen. Att använda Assert() kan skapa säkerhetsproblem. (Ärvd från CodeAccessPermission) |
| Copy() |
Skapar en kopia av en WebPermission. |
| Demand() |
Tvingar fram en SecurityException vid körning om alla anropare högre i anropsstacken inte har beviljats den behörighet som anges av den aktuella instansen. (Ärvd från CodeAccessPermission) |
| Deny() |
Föråldrad.
Hindrar anropare högre i anropsstacken från att använda koden som anropar den här metoden för att komma åt resursen som anges av den aktuella instansen. (Ärvd från CodeAccessPermission) |
| Equals(Object) |
Avgör om det angivna CodeAccessPermission objektet är lika med det aktuella CodeAccessPermission. (Ärvd från CodeAccessPermission) |
| FromXml(SecurityElement) |
Rekonstruerar en WebPermission från en XML-kodning. |
| GetHashCode() |
Hämtar en hash-kod för objektet CodeAccessPermission som är lämpligt för användning i hash-algoritmer och datastrukturer, till exempel en hash-tabell. (Ärvd från CodeAccessPermission) |
| GetType() |
Hämtar den aktuella instansen Type . (Ärvd från Object) |
| Intersect(IPermission) |
Returnerar den logiska skärningspunkten för två WebPermission instanser. |
| IsSubsetOf(IPermission) |
Avgör om den aktuella är WebPermission en delmängd av det angivna objektet. |
| IsUnrestricted() |
Kontrollerar det övergripande behörighetstillståndet för WebPermission. |
| MemberwiseClone() |
Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object) |
| PermitOnly() |
Hindrar anropare högre i anropsstacken från att använda koden som anropar den här metoden för att komma åt alla resurser förutom den resurs som anges av den aktuella instansen. (Ärvd från CodeAccessPermission) |
| ToString() |
Skapar och returnerar en strängrepresentation av det aktuella behörighetsobjektet. (Ärvd från CodeAccessPermission) |
| ToXml() |
Skapar en XML-kodning av en WebPermission och dess aktuella tillstånd. |
| Union(IPermission) |
Returnerar den logiska unionen mellan två instanser av WebPermission klassen. |