Freigeben über


Clipboard.SetText Method

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Sets Unicode text data to store on the clipboard, for later access with GetText.

Namespace:  System.Windows
Assembly:  System.Windows (in System.Windows.dll)

Syntax

'Declaration
Public Shared Sub SetText ( _
    text As String _
)
public static void SetText(
    string text
)

Parameters

  • text
    Type: System.String
    A string that contains the Unicode text data to store on the clipboard.

Exceptions

Exception Condition
SecurityException

Invoked this method from outside a user-initiated context.

-or-

Clipboard access user dialog box was not confirmed.

Remarks

Under partial trust (the default mode), Silverlight restricts clipboard access to its two key APIs: GetText and SetText. These APIs can only be invoked from within a context that is determined by the Silverlight runtime to be in response to a user-initiated action. For example, clipboard access is valid from within a handler for a Click or KeyDown event. For examples of situations that are not considered user-initiated, clipboard access is not valid from a handler for Loaded or from a constructor. Clipboard access under partial trust also requires the user to confirm access through completion of a Silverlight access-confirmation dialog box.

If you specifically produce an out-of-browser application and request elevated trust, this security restriction on the API and its dialog box are not used. For more information, see Trusted Applications.

Version Information

Silverlight

Supported in: 5, 4

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.