AssetUrlSelector.GetClientLaunchPickerReference-Methode (String)

Artikel
03/15/2016

Generiert eine ECMAScript (JavaScript, JScript)-Clientzeichenfolge, die das Dialogfeld Ressourcenauswahl mit der durch die Eigenschaften dieses Steuerelements angegebenen Konfiguration öffnet.

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

Syntax

'Declaration
Public Function GetClientLaunchPickerReference ( _
    currentAssetUrl As String _
) As String
'Usage
Dim instance As AssetUrlSelector
Dim currentAssetUrl As String
Dim returnValue As String

returnValue = instance.GetClientLaunchPickerReference(currentAssetUrl)

public string GetClientLaunchPickerReference(
    string currentAssetUrl
)

Parameter

currentAssetUrl
Typ: System.String

ECMAScript (JavaScript, JScript)-Clientzeichenfolge, die einen Zeichenfolgenwert auswertet, der an das Dialogfeld Ressourcenauswahl als aktueller Wert übergeben werden soll.

Rückgabewert

Typ: System.String
Eine ECMAScript (JavaScript, JScript)-Clientzeichenfolge, die das Dialogfeld Ressourcenauswahl mit der durch die Eigenschaften dieses Steuerelements angegebenen Konfiguration öffnet.

Ausnahmen

Ausnahme	Bedingung
NullReferenceException	Eine ein Nullverweis (Nothing in Visual Basic)-Verweis-Ausnahme wird ausgelöst, wenn die Page-Eigenschaft dieses Steuerelements nicht auf ein gültiges System.Web.UI.Page-Objekt für die Registrierung des erforderlichen ECMAScript (JavaScript, JScript) festgelegt ist. Fügen Sie das Steuerelement einer Steuerelementauflistung auf der Seite hinzu, oder legen Sie die Page-Eigenschaft direkt fest.

Hinweise

Der currentAssetUrlECMAScript (JavaScript, JScript)-Parameter bestimmt den aktuellen Wert, der an das Dialogfeld Ressourcenauswahl übergeben wird. Sie können diese Methode verwenden, wenn das Dialogfeld Ressourcenauswahl von einem anderen HTML-Element als der bereitgestellten Schaltfläche geöffnet wird. Sie können Eigenschaften für dieses Steuerelement und die Eigenschaften Visible, AssetPickerButtonVisible und AssetUrlTextBoxVisible auf false festlegen. Sie können die von dieser Funktion zurückgegebene ECMAScript-Zeichenfolge in einem HTML-Element einer onclick-Clientfunktion oder in einem ausgegebenen ECMAScript (JavaScript, JScript)-Block verwenden, um das Dialogfeld Ressourcenauswahl zu öffnen. Sie müssen die GetClientLaunchPickerReference-Methode vor oder während der OnPreRender-Phase des Lebenszyklus der Seite aufrufen und Eigenschaften vor dem Aufruf der Methode festlegen, um das richtige Client-ECMAScript (JavaScript, JScript) auf der Seite registriert wird. Änderungen an den Eigenschaften des Steuerelements nach dem Aufruf von GetClientLaunchPickerReference haben keinen Einfluss auf das Verhalten des Dialogfelds, da das steuernde Clientskript bereits auf der Seite registriert ist.

Beispiele

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