WebPermission Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Perhatian
Code Access Security is not supported or honored by the runtime.
Mengontrol hak untuk mengakses sumber daya Http Internet.
public ref class WebPermission sealed : System::Security::CodeAccessPermission, System::Security::Permissions::IUnrestrictedPermission
[System.Obsolete("Code Access Security is not supported or honored by the runtime.", DiagnosticId="SYSLIB0003", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public sealed class WebPermission : System.Security.CodeAccessPermission, System.Security.Permissions.IUnrestrictedPermission
[System.Serializable]
public sealed class WebPermission : System.Security.CodeAccessPermission, System.Security.Permissions.IUnrestrictedPermission
public sealed class WebPermission : System.Security.CodeAccessPermission, System.Security.Permissions.IUnrestrictedPermission
[<System.Obsolete("Code Access Security is not supported or honored by the runtime.", DiagnosticId="SYSLIB0003", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
type WebPermission = class
inherit CodeAccessPermission
interface IUnrestrictedPermission
[<System.Serializable>]
type WebPermission = class
inherit CodeAccessPermission
interface IUnrestrictedPermission
type WebPermission = class
inherit CodeAccessPermission
interface IUnrestrictedPermission
Public NotInheritable Class WebPermission
Inherits CodeAccessPermission
Implements IUnrestrictedPermission
- Warisan
- Atribut
- Penerapan
Keterangan
Perhatian
Keamanan Akses Kode (CAS) tidak digunakan lagi di semua versi .NET Framework dan .NET. Versi terbaru .NET tidak mematuhi anotasi CAS dan menghasilkan kesalahan jika API terkait CAS digunakan. Pengembang harus mencari cara alternatif untuk menyelesaikan tugas keamanan.
WebPermission menyediakan sekumpulan metode dan properti untuk mengontrol akses ke sumber daya Internet. Anda dapat menggunakan WebPermission untuk menyediakan akses terbatas atau tidak terbatas ke sumber daya Anda, berdasarkan PermissionState yang diatur saat WebPermission dibuat.
Buat WebPermission instans dengan memanggil konstruktornya menggunakan salah satu set parameter berikut:
Tidak ada parameter. PermissionState Defaultnya adalah None.
PermissionState. Tentukan untuk Unrestricted mengizinkan URI apa pun digunakan di kelas target, atau None untuk mengizinkan akses hanya ke URI yang Anda tentukan melalui penggunaan AddPermission metode .
Nilai NetworkAccess dan string URI. URI yang ditentukan memiliki izin yang diberikan oleh NetworkAccess nilai .
Penentu NetworkAccess dan ekspresi reguler URI.
dan ConnectListAcceptList tahan URI tempat Anda telah memberikan izin akses. Untuk menambahkan URI ke salah satu daftar ini, gunakan AddPermission. Jika Anda meneruskan AcceptNetworkAccess sebagai parameter, URI akan ditambahkan ke AcceptList. WebPermission akan memungkinkan koneksi ke kelas target Anda dengan URI yang AcceptListcocok dengan .
Perhatian
Untuk menolak akses ke sumber daya Internet, Anda harus menolak akses ke semua jalur yang mungkin ke sumber daya tersebut. Ini memerlukan panggilan WebPermission.WebPermission dengan parameter status yang diatur ke Deny. Pendekatan yang lebih baik adalah mengizinkan akses ke sumber daya tertentu saja.
Nota
Anda perlu menolak akses hanya menggunakan jalur kanonis sumber daya. Tidak perlu menggunakan semua variasi sinonis jalur.
Nota
Nama pengguna dan informasi port default dilucuti dari Uri sebelum perbandingan dengan argumen ekspresi reguler yang disediakan ke WebPermission(NetworkAccess, Regex) konstruktor. Jika ekspresi reguler berisi informasi pengguna atau nomor port default, maka semua yang masuk Uriakan gagal mencocokkan ekspresi reguler.
Konstruktor
| Nama | Deskripsi |
|---|---|
| WebPermission() |
Kedaluwarsa.
Membuat instans WebPermission baru kelas. |
| WebPermission(NetworkAccess, Regex) |
Kedaluwarsa.
Menginisialisasi instans WebPermission baru kelas dengan hak akses yang ditentukan untuk ekspresi reguler URI yang ditentukan. |
| WebPermission(NetworkAccess, String) |
Kedaluwarsa.
Menginisialisasi instans WebPermission baru kelas dengan hak akses yang ditentukan untuk URI yang ditentukan. |
| WebPermission(PermissionState) |
Kedaluwarsa.
Membuat instans WebPermission baru kelas yang melewati semua tuntutan atau gagal semua tuntutan. |
Properti
| Nama | Deskripsi |
|---|---|
| AcceptList |
Kedaluwarsa.
Properti ini mengembalikan enumerasi dari satu izin penerimaan yang dipegang oleh ini WebPermission. Jenis objek yang mungkin terkandung dalam enumerasi yang dikembalikan adalah String dan Regex. |
| ConnectList |
Kedaluwarsa.
Properti ini mengembalikan enumerasi dari satu izin koneksi yang dipegang oleh ini WebPermission. Jenis objek yang mungkin terkandung dalam enumerasi yang dikembalikan adalah String dan Regex. |
Metode
| Nama | Deskripsi |
|---|---|
| AddPermission(NetworkAccess, Regex) |
Kedaluwarsa.
Menambahkan URI yang ditentukan dengan hak akses yang ditentukan ke .WebPermission |
| AddPermission(NetworkAccess, String) |
Kedaluwarsa.
Menambahkan string URI yang ditentukan dengan hak akses yang ditentukan ke .WebPermission |
| Assert() |
Kedaluwarsa.
Menyatakan bahwa kode panggilan dapat mengakses sumber daya yang dilindungi oleh permintaan izin melalui kode yang memanggil metode ini, bahkan jika penelepon yang lebih tinggi di tumpukan belum diberikan izin untuk mengakses sumber daya. Menggunakan Assert() dapat membuat masalah keamanan. (Diperoleh dari CodeAccessPermission) |
| Copy() |
Kedaluwarsa.
Membuat salinan WebPermission. |
| Demand() |
Kedaluwarsa.
SecurityException Memaksa pada waktu proses jika semua penelepon yang lebih tinggi dalam tumpukan panggilan belum diberikan izin yang ditentukan oleh instans saat ini. (Diperoleh dari CodeAccessPermission) |
| Deny() |
Kedaluwarsa.
Kedaluwarsa.
Mencegah penelepon yang lebih tinggi dalam tumpukan panggilan menggunakan kode yang memanggil metode ini untuk mengakses sumber daya yang ditentukan oleh instans saat ini. (Diperoleh dari CodeAccessPermission) |
| Equals(Object) |
Kedaluwarsa.
Menentukan apakah objek yang ditentukan CodeAccessPermission sama dengan objek saat ini CodeAccessPermission. (Diperoleh dari CodeAccessPermission) |
| FromXml(SecurityElement) |
Kedaluwarsa.
Rekonstruksi WebPermission dari pengodean XML. |
| GetHashCode() |
Kedaluwarsa.
Mendapatkan kode hash untuk CodeAccessPermission objek yang cocok untuk digunakan dalam algoritma hashing dan struktur data seperti tabel hash. (Diperoleh dari CodeAccessPermission) |
| GetType() |
Kedaluwarsa.
Mendapatkan Type instans saat ini. (Diperoleh dari Object) |
| Intersect(IPermission) |
Kedaluwarsa.
Mengembalikan persimpangan logis dari dua WebPermission instans. |
| IsSubsetOf(IPermission) |
Kedaluwarsa.
Menentukan apakah saat ini WebPermission adalah subset dari objek yang ditentukan. |
| IsUnrestricted() |
Kedaluwarsa.
Memeriksa status izin keseluruhan dari WebPermission. |
| MemberwiseClone() |
Kedaluwarsa.
Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object) |
| PermitOnly() |
Kedaluwarsa.
Mencegah penelepon yang lebih tinggi dalam tumpukan panggilan menggunakan kode yang memanggil metode ini untuk mengakses semua sumber daya kecuali untuk sumber daya yang ditentukan oleh instans saat ini. (Diperoleh dari CodeAccessPermission) |
| ToString() |
Kedaluwarsa.
Membuat dan mengembalikan representasi string dari objek izin saat ini. (Diperoleh dari CodeAccessPermission) |
| ToXml() |
Kedaluwarsa.
Membuat pengodean XML dari dan WebPermission statusnya saat ini. |
| Union(IPermission) |
Kedaluwarsa.
Mengembalikan serikat logis antara dua instans WebPermission kelas. |