Clipboard.SetText Method

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

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


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


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


Exception Condition

Invoked this method from outside a user-initiated context.


Clipboard access user dialog box was not confirmed.


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


Supported in: 5, 4

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1


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