MachineKeySection.ValidationKey Properti

Definisi

Ruang nama:

System.Web.Configuration

Rakitan:

System.Web.dll

Mendapatkan atau mengatur kunci yang digunakan untuk memvalidasi autentikasi formulir dan melihat data status, atau proses di mana kunci dibuat.

public:
 property System::String ^ ValidationKey { System::String ^ get(); void set(System::String ^ value); };

[System.ComponentModel.TypeConverter(typeof(System.Configuration.WhiteSpaceTrimStringConverter))]
[System.Configuration.ConfigurationProperty("validationKey", DefaultValue="AutoGenerate,IsolateApps")]
[System.Configuration.StringValidator(MinLength=1)]
public string ValidationKey { get; set; }

[<System.ComponentModel.TypeConverter(typeof(System.Configuration.WhiteSpaceTrimStringConverter))>]
[<System.Configuration.ConfigurationProperty("validationKey", DefaultValue="AutoGenerate,IsolateApps")>]
[<System.Configuration.StringValidator(MinLength=1)>]
member this.ValidationKey : string with get, set

Public Property ValidationKey As String

Nilai Properti

String

Nilai kunci, atau nilai yang menunjukkan bagaimana kunci dihasilkan. Defaultnya adalah "AutoGenerate,IsolateApps".

Atribut

TypeConverterAttribute ConfigurationPropertyAttribute StringValidatorAttribute

Contoh

Contoh berikut menunjukkan cara mengatur ValidationKey properti dengan menggunakan kode. Contoh ini adalah bagian dari contoh yang lebih besar yang disediakan untuk MachineKeySection kelas .

// Display ValidationKey property.
Console.WriteLine("ValidationKey: {0}",
  configSection.ValidationKey);

' Display ValidationKey property.
Console.WriteLine("ValidationKey: {0}", _
 configSection.ValidationKey)

Keterangan

Properti ValidationKey digunakan ketika enableViewStateMAC adalah true untuk membuat kode autentikasi pesan (MAC) untuk mengaktifkan ASP.NET untuk menentukan apakah status tampilan telah diubah. Properti ValidationKey ini juga digunakan untuk menghasilkan ID sesi khusus aplikasi yang tidak diproses untuk memastikan bahwa variabel status sesi terisolasi di antara aplikasi.

Gunakan opsi "AutoGenerate" untuk menentukan bahwa ASP.NET menghasilkan kunci acak dan menyimpannya di Otoritas Keamanan Lokal. Opsi "AutoGenerate" adalah bagian dari nilai default.

Jika Anda menambahkan pengubah "IsolateApps" ke nilai "AutoGenerate" ValidationKey , ASP.NET menghasilkan kunci terenkripsi unik untuk setiap aplikasi dengan menggunakan setiap aplikasi AppDomainAppVirtualPath. Ini adalah pengaturan default.

Jika Anda menambahkan pengubah "IsolateByAppId" ke nilai "AutoGenerate" ValidationKey , ASP.NET menghasilkan kunci terenkripsi unik untuk setiap aplikasi dengan menggunakan setiap aplikasi AppDomainAppId. Jika dua aplikasi berbeda berbagi jalur virtual (mungkin karena aplikasi tersebut berjalan pada port yang berbeda), bendera ini dapat digunakan untuk lebih membedakannya satu sama lain. Bendera "IsolateByAppId" hanya dipahami oleh ASP.NET 4.5, tetapi dapat digunakan terlepas dari pengaturannya MachineKeySection.CompatibilityMode .

Jika Anda perlu mendukung konfigurasi di seluruh jaringan server Web (farm Web), atur ValidationKey properti secara manual untuk memastikan konfigurasi yang konsisten. Untuk informasi tentang cara membuat nilai secara manual untuk DecryptionKey atribut, lihat Cara: Mengonfigurasi MachineKey di ASP.NET 2.0.

Properti ini biasanya diatur secara deklaratif dalam validationKey atribut elemen machineKey dari file Web.config.