AssetUrlSelector.GetClientLaunchPickerReference método (String)

Artigo
03/15/2016

Gera uma seqüência de ECMAScript (JavaScript, JScript) de cliente usada para abrir a caixa de diálogo Seletor de ativo com a configuração especificada pelas propriedades deste controle.

Namespace: Microsoft.SharePoint.Publishing.WebControls
Assembly: Microsoft.SharePoint.Publishing (em Microsoft.SharePoint.Publishing.dll)

Sintaxe

'Declaração
Public Function GetClientLaunchPickerReference ( _
    currentAssetUrl As String _
) As String
'Uso
Dim instance As AssetUrlSelector
Dim currentAssetUrl As String
Dim returnValue As String

returnValue = instance.GetClientLaunchPickerReference(currentAssetUrl)

public string GetClientLaunchPickerReference(
    string currentAssetUrl
)

Parâmetros

currentAssetUrl
Tipo: System.String

String de ECMAScript (JavaScript, JScript) de cliente que avalia um valor de seqüência de caracteres a serem passados para a caixa de diálogo Seletor de ativos como o valor atual.

Valor retornado

Tipo: System.String
Uma seqüência de ECMAScript (JavaScript, JScript) de cliente usada para abrir a caixa de diálogo Seletor de ativo com a configuração especificada pelas propriedades deste controle.

Exceções

Exceção	Condição
NullReferenceException	Uma exceção de referência de uma referência nula (Nothing no Visual Basic) é lançada se a propriedade Page do controle não estiver definida para um objeto válido System.Web.UI.Page para registrar o necessário ECMAScript (JavaScript, JScript). Adicione o controle a uma coleção de controles na página ou definir diretamente a propriedade Page .

Comentários

O parâmetro deECMAScript (JavaScript, JScript) de currentAssetUrldetermina o valor atual passado para a caixa de diálogo Seletor de ativo . Você pode usar esse método se a caixa de diálogo Seletor de ativo é aberta de um elemento HTML que não seja o botão fornecido. Você pode definir propriedades nesse controle e as propriedades Visible, AssetPickerButtonVisiblee AssetUrlTextBoxVisible para false. Você pode usar a seqüência de caracteres do ECMAScript retornada por essa função em uma função de onclick do cliente de elemento HTML ou um bloco emitido ECMAScript (JavaScript, JScript) para abrir a caixa de diálogo Seletor de ativo . Você deve chamar o método GetClientLaunchPickerReference durante ou antes da fase de OnPreRender de ciclo de vida da página e você deve definir as propriedades antes de chamar esse método para registrar o cliente correto ECMAScript (JavaScript, JScript)a página. Todas as alterações para as propriedades do controle após a chamada para GetClientLaunchPickerReference não afetam o comportamento da caixa de diálogo porque o script de cliente, controle de caixa de diálogo já está registrado na página.

Exemplos

    // Set the ECMAScript to perform after populating the text boxes with the returned values.assetSelector.ClientCallback = ScriptClientCallback;
string clientLaunchPickerScript;if(launchPickerWithCurrentBrowserUrl){
// Use a client launch script that calculates
// the current asset URL with custom ECMAScript
// which in this example always is the current browser location URL.
clientLaunchPickerScript = assetSelector.GetClientLaunchPickerReference(ScriptGetAssetUrlValue);}else{
// Use the default client launch script that gets the
// current asset URL value based on the AssetUrlClientID.
clientLaunchPickerScript = assetSelector.GetClientLaunchPickerReference();}
// Add the client launch script as an ondoubleclick handler for the two text boxes.assetUrlControl.Attributes["ondblclick"] = clientLaunchPickerScript + "; return false;";assetTextControl.Attributes["ondblclick"] = clientLaunchPickerScript + "; return false;";
// Return the client launch script, which can be added to other ECMAScript on the pagereturn clientLaunchPickerScript;

' Set the ECMAScript to perform after populating the text boxes with the returned values.
assetSelector.ClientCallback = ScriptClientCallback

Dim clientLaunchPickerScript As String
If launchPickerWithCurrentBrowserUrl Then' Use a client launch script that calculates' the current asset URL with custom ECMAScript' which in this example always is the current browser location URL.clientLaunchPickerScript = assetSelector.GetClientLaunchPickerReference(ScriptGetAssetUrlValue)
Else' Use the default client launch script that gets the' current asset URL value based on the AssetUrlClientID.clientLaunchPickerScript = assetSelector.GetClientLaunchPickerReference()
End If

' Add the client launch script as an ondoubleclick handler for the two text boxes.
assetUrlControl.Attributes("ondblclick") = clientLaunchPickerScript & "; return false;"
assetTextControl.Attributes("ondblclick") = clientLaunchPickerScript & "; return false;"

' Return the client launch script, which can be added to other ECMAScript on the page
Return clientLaunchPickerScript