Bagikan melalui

WebPartPersonalization.ToggleScope Metode

  • Referensi

Definisi

Ruang nama:
System.Web.UI.WebControls.WebParts
Rakitan:
System.Web.dll

Mengalihkan cakupan personalisasi halaman saat ini dari User ke Shared atau dari Shared ke User.

public:
 virtual void ToggleScope();
public virtual void ToggleScope ();
abstract member ToggleScope : unit -> unit
override this.ToggleScope : unit -> unit
Public Overridable Sub ToggleScope ()

Pengecualian

InvalidOperationException

Pengguna saat ini tidak memiliki kemampuan pengguna untuk memasukkan Shared cakupan saat mencoba beralih dari User cakupan ke Shared cakupan.

-atau-

Instans WebPartPersonalization belum menyelesaikan inisialisasi.

-atau-

Instans Page untuk yang terkait WebPartManager adalah null.

-atau-

Nilai Request properti pada WebPartManager instans terkait Page kontrol adalah null.

ArgumentOutOfRangeException

Upaya dilakukan untuk beralih ke cakupan yang tidak ditentukan dalam PersonalizationScope enumerasi. Secara teknis, situasi ini seharusnya tidak pernah terjadi.

Contoh

Kode berikut menunjukkan menggunakan ToggleScope metode . Kode ini adalah bagian dari sampel kode yang lebih besar yang ditemukan dalam WebPartPersonalization deskripsi kelas.

// Allows authorized user to change personalization scope.
protected void Toggle_Scope_Button_Click(object sender, EventArgs e)
{
    if (_manager.Personalization.CanEnterSharedScope)
    {
        _manager.Personalization.ToggleScope();
    }
    
}

' Allows authorized user to change personalization scope.
Protected Sub Toggle_Scope_Button_Click(ByVal sender As Object, ByVal e As EventArgs) 
    If _manager.Personalization.CanEnterSharedScope Then
        _manager.Personalization.ToggleScope()
    End If

End Sub 'Toggle_Scope_Button_Click

Keterangan

Metode ini mengalihkan cakupan personalisasi halaman yang sedang dijalankan. Mengalihkan cakupan menghasilkan Transfer kembali ke halaman eksekusi saat ini.

Metode ini tidak melakukan operasi jika dipanggil ketika ekspor atau impor kontrol Bagian Web sedang terjadi.

Jika permintaan cakupan pengalih terjadi untuk halaman yang dikirimkan melalui POST permintaan, maka nilai string kueri apa pun akan dipertahankan selama transfer; parameter string kueri tidak dipertahankan jika halaman dikirimkan melalui GET permintaan.

Berlaku untuk

Lihat juga