Aracılığıyla paylaş

WebPartPersonalization.ToggleScope Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.Web.UI.WebControls.WebParts
Bütünleştirilmiş Kod:
System.Web.dll

Geçerli sayfanın kişiselleştirme kapsamını UserSharedSharedUserile veya ile değiştirir.

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

Özel durumlar

InvalidOperationException

Geçerli kullanıcının kapsamdan kapsama geçiş User yapmaya çalışırken kapsam Shared girme Shared özelliği yok.

-veya-

Örnek WebPartPersonalization başlatmayı tamamlamadı.

-veya-

İlişkili PageWebPartManager örneği şeklindedir null.

-veya-

Denetimin Request ilişkili Page örneğindeki özelliğinin WebPartManager değeri şeklindedirnull.

ArgumentOutOfRangeException

Numaralandırmada PersonalizationScope tanımlanmayan bir kapsama geçiş yapmaya çalışıldı. Teknik olarak, bu durum asla gerçekleşmemelidir.

Örnekler

Aşağıdaki kod yönteminin ToggleScope kullanılmasını gösterir. Bu kod, sınıf açıklamasında bulunan daha büyük bir kod örneğinin WebPartPersonalization bir parçasıdır.

// 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

Açıklamalar

Bu yöntem, o anda yürütülen sayfanın kişiselleştirme kapsamını değiştirir. Kapsamın Transfer geçişini yapmak, geçerli yürütülen sayfaya geri döner.

Bir Web Bölümleri denetiminin dışarı veya içeri aktarılması gerçekleşirken çağrılırsa bu yöntem hiçbir işlem gerçekleştirmez.

İstek yoluyla POST gönderilen bir sayfa için geçiş kapsamı isteği oluşursa, aktarım sırasında sorgu dizesi değerleri korunur; sayfa bir GET istek aracılığıyla gönderildiyse sorgu dizesi parametreleri korunmaz.

Şunlara uygulanır

Ayrıca bkz.