AssetUrlSelector.GetClientLaunchPickerReference-Methode
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 As String
'Usage
Dim instance As AssetUrlSelector
Dim returnValue As String
returnValue = instance.GetClientLaunchPickerReference()
public string GetClientLaunchPickerReference()
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 Eigenschaften Page und ID dieses Steuerelements nicht auf ein gültiges System.Web.UI.Page-Objekt für die Registrierung des erforderlichen ECMAScript festgelegt sind. Fügen Sie das Steuerelement einer Steuerelementauflistung auf der Seite hinzu, oder legen Sie die Eigenschaften Page und ID direkt fest. |
Hinweise
Der aktuelle an das Dialogfeld Ressourcenauswahl übergebene Wert wird aus dem Wert der AssetUrl-Eigenschaft oder der AssetUrlClientID-Eigenschaft bestimmt. Sie können diese Methode verwenden, wenn das Dialogfeld Ressourcenauswahl aus einem anderen HTML-Element als der bereitgestellten Schaltfläche geöffnet wird. Sie können Eigenschaften für dieses Steuerelement festlegen, und die Eigenschaften Visible, AssetPickerButtonVisible() oder AssetUrlTextBoxVisible() können auf false festgelegt werden. Sie können die von dieser Funktion zurückgegebene ECMAScript-Zeichenfolge in einem HTML-Element einer onclick-Clientfunktion oder in einem ausgegebenen ECMAScript-Block verwenden, um das Dialogfeld Ressourcenauswahl zu öffnen.
Die GetClientLaunchPickerReference-Methode muss vor oder während der OnPreRender-Phase des Lebenszyklus der Seite aufgerufen werden, und Sie müssen Eigenschaften festlegen, bevor Sie diese Methode aufrufen, um den richtigen Client-ECMAScript-Code auf der Seite zu registrieren. Änderungen an den Eigenschaften des Steuerelements nach dem Aufruf der GetClientLaunchPickerReference-Methode haben keinen Einfluss auf das Verhalten des Dialogfelds Ressourcenauswahl, da das steuernde Clientskript bereits auf der Seite registriert ist.
Beispiele
// Setting the Page and ID properties is required when the// AssetUrlSelector control is not added to the page// control tree because// the AssetUrlSelector.GetClientLaunchPickerReference()// method must register script in the page.assetSelector.Page = containerControl.Page;assetSelector.ID = "SampleGenerateAssetUrlSelectorLaunchScript";
// Uses text box client ID to connect the Asset// Picker to the text boxes for the resulting// URL and default text values returned from the// Asset Picker dialog box.assetSelector.AssetUrlClientID = assetUrlControl.ClientID;assetSelector.AssetTextClientID = assetTextControl.ClientID;
// 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
// that in this sample is always 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 page.return clientLaunchPickerScript;
' Setting the Page and ID properties is required when the
' AssetUrlSelector control is not added to the page
' control tree because
' the AssetUrlSelector.GetClientLaunchPickerReference()
' method must register script in the page.
assetSelector.Page = containerControl.Page
assetSelector.ID = "SampleGenerateAssetUrlSelectorLaunchScript"
' Uses text box client ID to connect the Asset
' Picker to the text boxes for the resulting
' URL and default text values returned from the
' Asset Picker dialog box.
assetSelector.AssetUrlClientID = assetUrlControl.ClientID
assetSelector.AssetTextClientID = assetTextControl.ClientID
' 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' that in this sample is always 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 AssetUrlClientIDclientLaunchPickerScript = 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
Siehe auch
Referenz
GetClientLaunchPickerReference-Überladung