AspNetHostingPermission Klasa

Definicja

Kontroluje uprawnienia dostępu w środowiskach hostowanych ASP.NET.Controls access permissions in ASP.NET hosted environments. Klasa ta nie może być dziedziczona.This class cannot be inherited.

public ref class AspNetHostingPermission sealed : System::Security::CodeAccessPermission, System::Security::Permissions::IUnrestrictedPermission
public sealed class AspNetHostingPermission : System.Security.CodeAccessPermission, System.Security.Permissions.IUnrestrictedPermission
[System.Serializable]
public sealed class AspNetHostingPermission : System.Security.CodeAccessPermission, System.Security.Permissions.IUnrestrictedPermission
type AspNetHostingPermission = class
    inherit CodeAccessPermission
    interface IUnrestrictedPermission
Public NotInheritable Class AspNetHostingPermission
Inherits CodeAccessPermission
Implements IUnrestrictedPermission
Dziedziczenie
AspNetHostingPermission
Atrybuty
Implementuje

Przykłady

Poniższy przykład kodu przedstawia klasę chronioną za pomocą uprawnienia AspNetHostingPermission.The following code example shows a class protected using the AspNetHostingPermission permission. Aby można było utworzyć wystąpienie klasy, kod musi być uruchomiony z co najmniej MinimalAspNetHostingPermission uprawnień Level.Code must be running with at least MinimalAspNetHostingPermission permission Level in order to create an instance of the class.

using System;
using System.Web;
using System.Security.Permissions;

[AspNetHostingPermission(SecurityAction.Demand, Level=AspNetHostingPermissionLevel.Medium)]
public class CustomAspNetClass
{
}
Imports System.Web
Imports System.Security.Permissions

<AspNetHostingPermission(SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Medium)> _
Public Class CustomAspNetClass

End Class

Uwagi

Klasa AspNetHostingPermission jest używana w połączeniu z zabezpieczeniami dostępu kodu, aby chronić publiczne typy w przestrzeniach nazw System. Web.The AspNetHostingPermission class is used in conjunction with code access security to help protect public types in the System.Web namespaces. Do kodu musi być przypisany co najmniej Minimal poziom zaufania, aby uzyskać dostęp do chronionych klas ASP.NET.Code must be assigned at least the Minimal trust level to access protected ASP.NET classes.

Właściwość Level klasy AspNetHostingPermission jest ustawiana przez skonfigurowanie odpowiedniego poziomu zaufania w elemencie konfiguracji zaufania .The AspNetHostingPermission class's Level property is set by configuring the appropriate trust level in the trust configuration element. Domyślnie atrybut level elementu konfiguracji trust jest ustawiony na Full.By default, the level attribute of the trust configuration element is set to Full. Oznacza to, że domyślnie aplikacje ASP.NET są uruchamiane na poziomie Unrestricted.That is, by default, ASP.NET applications run under the Unrestricted level. Po utworzeniu domeny aplikacji ASP.NET ASP.NET odczytuje wartość określoną dla atrybutu level elementu konfiguracji trust, tworzy wystąpienie klasy AspNetHostingPermission z określonym atrybutem Level, a następnie dodaje klasę do zestawu uprawnień dla domeny aplikacji.When an ASP.NET application domain is created, ASP.NET reads the value specified for the level attribute of the trust configuration element, creates an instance of the AspNetHostingPermission class with the specified Level attribute, and then adds the class to the permission set for the application domain. Aby uzyskać więcej informacji, zobacz ASP.NET poziomów zaufania i plików zasad.For more information, see ASP.NET Trust Levels and Policy Files.

Zaleca się, aby ustawić atrybut level elementu konfiguracji trust High dla zaufanych witryn.It is recommended that you set the level attribute of the trust configuration element to High for sites that are trusted. W przypadku niezaufanych lokacji, takich jak serwer sieci Web, który hostuje Lokacje uruchamiające kod pochodzący od zewnętrznego klienta, zaleca się ustawić atrybut level elementu konfiguracji trust, aby Medium.For sites that are not trusted, such as a Web server that hosts sites that run code from an external customer, it is recommended that you set the level attribute of the trust configuration element to Medium.

Zestawy uprawnień, które są zdefiniowane domyślnie dla .NET Framework (na przykład LocalIntranet, Internet itd.) nie obejmują uprawnień AspNetHostingPermission.The permission sets that are defined by default for the .NET Framework (for example, LocalIntranet, Internet, and so on) do not include the AspNetHostingPermission permission. Oznacza to, że uprawnienie AspNetHostingPermission jest domyślnie przypisane tylko do aplikacji, które działają w ramach Full zaufania.That is, the AspNetHostingPermission permission is only assigned, by default, to applications that are running under Full trust.

Konstruktory

AspNetHostingPermission(AspNetHostingPermissionLevel)

Inicjuje nowe wystąpienie klasy AspNetHostingPermission z określonym poziomem uprawnień.Initializes a new instance of the AspNetHostingPermission class with the specified permission level.

AspNetHostingPermission(PermissionState)

Inicjuje nowe wystąpienie klasy AspNetHostingPermission z określoną wartością wyliczenia PermissionState.Initializes a new instance of the AspNetHostingPermission class with the specified PermissionState enumeration value.

Właściwości

Level

Pobiera lub ustawia bieżący poziom uprawnień hostingu dla aplikacji ASP.NET.Gets or sets the current hosting permission level for an ASP.NET application.

Metody

Assert()

Deklaruje, że kod wywołujący może uzyskać dostęp do zasobu chronionego przez żądanie dostępu za pomocą kodu, który wywołuje tę metodę, nawet jeśli obiekty wywołujące wyższego poziomu stosu nie uzyskały uprawnienia dostępu do zasobu.Declares that the calling code can access the resource protected by a permission demand through the code that calls this method, even if callers higher in the stack have not been granted permission to access the resource. Za pomocą Assert() można tworzyć problemy z zabezpieczeniami.Using Assert() can create security issues.

(Odziedziczone po CodeAccessPermission)
Copy()

Po zaimplementowaniu przez klasę pochodną program tworzy i zwraca identyczną kopię bieżącego obiektu uprawnienia.When implemented by a derived class, creates and returns an identical copy of the current permission object.

Demand()

Wymusza SecurityException w czasie wykonywania, jeśli wszyscy wywołujący znajdujący się wyżej w stosie wywołań nie udzielił uprawnień określonych przez bieżące wystąpienie.Forces a SecurityException at run time if all callers higher in the call stack have not been granted the permission specified by the current instance.

(Odziedziczone po CodeAccessPermission)
Deny()

Zapobiega wywoływaniu obiektów wywołujących w stosie wywołań przy użyciu kodu wywołującego tę metodę w celu uzyskania dostępu do zasobu określonego przez bieżące wystąpienie.Prevents callers higher in the call stack from using the code that calls this method to access the resource specified by the current instance.

(Odziedziczone po CodeAccessPermission)
Equals(Object)

Określa, czy określony obiekt CodeAccessPermission jest równy bieżącemu CodeAccessPermission.Determines whether the specified CodeAccessPermission object is equal to the current CodeAccessPermission.

(Odziedziczone po CodeAccessPermission)
FromXml(SecurityElement)

Rekonstruuje obiekt uprawnień z określonym stanem z kodowania XML.Reconstructs a permission object with a specified state from an XML encoding.

GetHashCode()

Pobiera kod skrótu dla obiektu CodeAccessPermission, który jest odpowiedni do użycia w algorytmach wyznaczania wartości skrótu i struktur danych, takich jak tabela skrótów.Gets a hash code for the CodeAccessPermission object that is suitable for use in hashing algorithms and data structures such as a hash table.

(Odziedziczone po CodeAccessPermission)
GetType()

Pobiera Type bieżącego wystąpienia.Gets the Type of the current instance.

(Odziedziczone po Object)
Intersect(IPermission)

W przypadku wdrożenia przez klasę pochodną program tworzy i zwraca uprawnienie, które jest częścią wspólną bieżącego uprawnienia i określonego uprawnienia.When implemented by a derived class, creates and returns a permission that is the intersection of the current permission and the specified permission.

IsSubsetOf(IPermission)

Zwraca wartość wskazującą, czy bieżące uprawnienie jest podzbiorem określonego uprawnienia.Returns a value indicating whether the current permission is a subset of the specified permission.

IsUnrestricted()

Zwraca wartość wskazującą, czy dozwolony jest nieograniczony dostęp do zasobu, który jest chroniony przez bieżące uprawnienie.Returns a value indicating whether unrestricted access to the resource that is protected by the current permission is allowed.

MemberwiseClone()

Tworzy skróconą kopię bieżącego Object.Creates a shallow copy of the current Object.

(Odziedziczone po Object)
PermitOnly()

Zapobiega wywoływaniu obiektów wywołujących w stosie wywołań przy użyciu kodu wywołującego tę metodę w celu uzyskania dostępu do wszystkich zasobów z wyjątkiem zasobu określonego przez bieżące wystąpienie.Prevents callers higher in the call stack from using the code that calls this method to access all resources except for the resource specified by the current instance.

(Odziedziczone po CodeAccessPermission)
ToString()

Tworzy i zwraca reprezentację ciągu dla bieżącego obiektu uprawnienia.Creates and returns a string representation of the current permission object.

(Odziedziczone po CodeAccessPermission)
ToXml()

Tworzy Kodowanie XML obiektu uprawnień i jego bieżący stan.Creates an XML encoding of the permission object and its current state.

Union(IPermission)

Tworzy uprawnienie, które jest złożeniem bieżącego uprawnienia i określonym uprawnieniem.Creates a permission that is the union of the current permission and the specified permission.

Jawne implementacje interfejsu

IPermission.Demand() (Odziedziczone po CodeAccessPermission)
IStackWalk.Assert() (Odziedziczone po CodeAccessPermission)
IStackWalk.Demand() (Odziedziczone po CodeAccessPermission)
IStackWalk.Deny() (Odziedziczone po CodeAccessPermission)
IStackWalk.PermitOnly() (Odziedziczone po CodeAccessPermission)

Dotyczy

Zobacz też