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ı UserShared ile veya olan SharedUserile 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 kapsama Shared girme Shared yeteneği yok.

-veya-

Örnek WebPartPersonalization başlatmayı tamamlamadı.

-veya-

Page İlişkili WebPartManager örneği şeklindedirnull.

-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 kullanılmasını ToggleScope gösterir. Bu kod, sınıf açıklamasında bulunan daha büyük bir kod örneğinin WebPartPersonalization 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, şu anda yürütülmekte olan sayfanın kişiselleştirme kapsamını değiştirir. Kapsamın geçişini yapmak, Transfer geçerli yürütme sayfasına geri döner.

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

İstek aracılığıyla 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.