Share via

WebPartPersonalization.ToggleScope Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Alterna l'ambito di personalizzazione della pagina corrente da User a Shared oppure da Shared a User.

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

Eccezioni

InvalidOperationException

L'utente corrente non dispone della funzionalità utente per accedere all'ambito del campo Shared quando si tenta di passare dall'ambito del campo User a quello del campo Shared.

-oppure-

L'istanza WebPartPersonalization non ha completato l'inizializzazione.

-oppure-

Il valore dell'istanza Page per il controllo WebPartManager associato è null.

-oppure-

Il valore della proprietà Request nell'istanza WebPartManager associata del controllo Page è null.

ArgumentOutOfRangeException

È stato effettuato un tentativo di passare a un ambito non definito nell'enumerazione PersonalizationScope. Dal punto di vista tecnico tale 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ù grande trovato 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 l'ambito di personalizzazione della pagina attualmente in esecuzione. Attivando l'ambito viene restituito un Transfer nuovo elemento alla pagina corrente in esecuzione.

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 ambito attiva per una pagina inviata tramite una POST richiesta, 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.

Si applica a

Vedi anche