Language

Clipboard.SetData(String, Object) メソッド

定義

名前空間:
System.Windows.Forms
アセンブリ:
System.Windows.Forms.dll
ソース:
Clipboard.cs
ソース:
Clipboard.cs
ソース:
Clipboard.cs
ソース:
Clipboard.cs
ソース:
Clipboard.cs

クリップボードをクリアし、指定した形式のデータを追加します。

public:
 static void SetData(System::String ^ format, System::Object ^ data);
public static void SetData(string format, object data);
static member SetData : string * obj -> unit
Public Shared Sub SetData (format As String, data As Object)

パラメーター

format
String

設定するデータの形式。 定義済みの形式については、 DataFormats を参照してください。

data
Object

追加するデータを表す Object 。

例外

ExternalException

クリップボードをクリアできませんでした。 これは通常、クリップボードが別のプロセスで使用されている場合に発生します。

ThreadStateException

現在のスレッドがシングル スレッド アパートメント (STA) モードではありません。 アプリケーションの STAThreadAttribute メソッドにMainを追加します。

ArgumentNullException

data は nullです。

例

このメンバーの例を次に示します。

// Demonstrates SetData, ContainsData, and GetData.
public Object SwapClipboardFormattedData(String format, Object data)
{
    Object returnObject = null;
    if (Clipboard.ContainsData(format))
    {
        returnObject = Clipboard.GetData(format);
        Clipboard.SetData(format, data);
    }
    return returnObject;
}

' Demonstrates SetData, ContainsData, and GetData.
Public Function SwapClipboardFormattedData( _
    ByVal format As String, ByVal data As Object) As Object

    Dim returnObject As Object = Nothing

    If (Clipboard.ContainsData(format)) Then
        returnObject = Clipboard.GetData(format)
        Clipboard.SetData(format, data)
    End If

    Return returnObject

End Function

注釈

ターゲット アプリケーションの形式がわからない場合は、このメソッドを使用して複数の形式でデータを格納できます。

このメソッドを使用して格納されたデータは、取得時に互換性のある形式に変換できます。

クリップボードから特定の形式のデータを取得するには、最初に ContainsData メソッドを使用して、 GetData メソッドを使用して取得する前に、クリップボードにその形式のデータが含まれているかどうかを判断します。

Note

Clipboard クラスは、単一スレッド アパートメント (STA) モードに設定されたスレッドでのみ使用できます。 このクラスを使用するには、 Main メソッドが STAThreadAttribute 属性でマークされていることを確認します。

適用対象

こちらもご覧ください