WebPartPersonalization.ToggleScope Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
public:
virtual void ToggleScope();public virtual void ToggleScope();abstract member ToggleScope : unit -> unit
override this.ToggleScope : unit -> unitPublic Overridable Sub ToggleScope ()Eccezioni
L'utente corrente non ha la capacità utente di immettere Shared l'ambito quando si tenta di passare dall'ambito User all'ambito Shared .
oppure
L'istanza non ha completato l'inizializzazione WebPartPersonalization .
oppure
L'istanza Page per l'oggetto associato WebPartManager è null.
oppure
Il valore della Request proprietà WebPartManager nell'istanza associata Page del controllo è null.
È stato effettuato un tentativo di passare a un ambito non definito nell'enumerazione PersonalizationScope . Tecnicamente, questa situazione non dovrebbe mai verificarsi.
Esempio
Il codice seguente illustra l'uso del ToggleScope metodo . Questo codice fa parte di un esempio di codice più ampio disponibile nella descrizione della WebPartPersonalization classe.
// 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
Commenti
Questo metodo attiva/disattiva l'ambito di personalizzazione della pagina attualmente in esecuzione. Attivare o disattivare l'ambito restituisce una Transfer pagina di nuovo alla pagina in esecuzione corrente.
Questo metodo non esegue alcuna operazione se viene chiamata durante l'esportazione o l'importazione di un controllo Web part.
Se si verifica una richiesta di attivazione/disattivazione dell'ambito per una pagina inviata tramite una POST richiesta, tutti i valori della stringa di query verranno mantenuti durante il trasferimento. I parametri della stringa di query non vengono mantenuti se la pagina è stata inviata tramite una GET richiesta.
