DataObject.GetDataPresent メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
この DataObject に格納されているデータが、指定した形式に関連付けられているかどうかを確認します。
オーバーロード
GetDataPresent(String) |
この DataObject に格納されているデータが、指定した形式と関連付けられているかどうかや、その形式に変換できるかどうかを確認します。 |
GetDataPresent(Type) |
この DataObject に格納されているデータが、指定した形式と関連付けられているかどうかや、その形式に変換できるかどうかを確認します。 |
GetDataPresent(String, Boolean) |
指定した形式のデータがこの DataObject に含まれているかどうかを確認し、オプションで、指定した形式に変換できるデータが含まれているかどうかも確認します。 |
GetDataPresent(String)
この DataObject に格納されているデータが、指定した形式と関連付けられているかどうかや、その形式に変換できるかどうかを確認します。
public:
virtual bool GetDataPresent(System::String ^ format);
public virtual bool GetDataPresent (string format);
abstract member GetDataPresent : string -> bool
override this.GetDataPresent : string -> bool
Public Overridable Function GetDataPresent (format As String) As Boolean
パラメーター
- format
- String
チェック対象となる形式。 定義済みの形式については、DataFormats のトピックを参照してください。
戻り値
この DataObject に格納されているデータが、指定されている形式に関連付けられている場合や、その形式に変換できる場合は true
。それ以外の場合は false
。
実装
例
次のコード例では、現在この DataObject に格納されているデータが、指定した形式に関連付けられているか、またはに変換できるかを決定します。 新 DataObject しい は、文字列とそれに関連付けられた書式をテキストとして指定して初期化されます。
次に、テキスト データが に存在するかどうかを出力します DataObject。 このコードでは、 が textBox1
作成されている必要があります。
注釈
を呼び出す前に形式が存在するかどうかを確認するには、このメソッドを呼び出します GetData。 この DataObjectで使用できる形式を呼び出GetFormatsします。
注意
データは、その変換が許可されていることを指定して格納されている場合、および要求された形式が格納された形式と互換性がある場合は、別の形式に変換できます。 たとえば、Unicode として格納されているデータをテキストに変換できます。
注意
データを取得できない場合、例外はスローされません。 代わりに、 false
が返されます。
こちらもご覧ください
適用対象
GetDataPresent(Type)
この DataObject に格納されているデータが、指定した形式と関連付けられているかどうかや、その形式に変換できるかどうかを確認します。
public:
virtual bool GetDataPresent(Type ^ format);
public virtual bool GetDataPresent (Type format);
abstract member GetDataPresent : Type -> bool
override this.GetDataPresent : Type -> bool
Public Overridable Function GetDataPresent (format As Type) As Boolean
パラメーター
戻り値
この DataObject に格納されているデータが、指定されている形式に関連付けられている場合や、その形式に変換できる場合は true
。それ以外の場合は false
。
実装
例
次のコード例では、指定した型のデータが に DataObject存在するかどうか、またはデータを指定した型に変換できるかどうかを判断します。 結果がテキスト ボックスに表示されます。 コードでは、 が textBox1
作成されている必要があります。
private:
void GetIfPresent2()
{
// Creates a component to store in the data object.
Component^ myComponent = gcnew Component;
// Creates a new data object and assigns it the component.
DataObject^ myDataObject = gcnew DataObject( myComponent );
// Creates a type to store the type of data.
Type^ myType = myComponent->GetType();
// Determines if the DataObject has data of the Type format.
textBox1->Text = String::Concat( "Is the specified data type available ",
"in the DataObject? ", myDataObject->GetDataPresent( myType ), "\n" );
// Retrieves the data using its type format, and displays the type.
Object^ myObject = myDataObject->GetData( myType );
textBox1->Text = String::Concat( textBox1->Text, "The data type stored ",
"in the DataObject is: ", myObject->GetType()->Name );
}
private void GetIfPresent2() {
// Creates a component to store in the data object.
Component myComponent = new Component();
// Creates a new data object and assigns it the component.
DataObject myDataObject = new DataObject(myComponent);
// Creates a type to store the type of data.
Type myType = myComponent.GetType();
// Determines if the DataObject has data of the Type format.
textBox1.Text = "Is the specified data type available in the " +
"DataObject? " + myDataObject.GetDataPresent(myType).ToString() + '\n';
// Retrieves the data using its type format, and displays the type.
Object myObject = myDataObject.GetData(myType);
textBox1.Text += "The data type stored in the DataObject is: " +
myObject.GetType().Name;
}
Private Sub GetIfPresent2()
' Creates a component to store in the data object.
Dim myComponent As New Component()
' Creates a new data object and assigns it the component.
Dim myDataObject As New DataObject(myComponent)
' Creates a type to store the type of data.
Dim myType As Type = myComponent.GetType()
' Determines if the DataObject has data of the Type format.
textBox1.Text = "Is the specified data type available in the " & "DataObject? " & _
myDataObject.GetDataPresent(myType).ToString() & ControlChars.Cr
' Retrieves the data using its type format, and displays the type.
Dim myObject As Object = myDataObject.GetData(myType)
textBox1.Text += "The data type stored in the DataObject is: " + myObject.GetType().Name
End Sub
注釈
を呼び出す前に形式が存在するかどうかを確認するには、このメソッドを呼び出します GetData。 この DataObjectで使用できる形式を呼び出GetFormatsします。
Note
データは、その変換が許可されていることを指定して格納されている場合、および要求された形式が格納された形式と互換性がある場合は、別の形式に変換できます。 たとえば、Unicode として格納されているデータをテキストに変換できます。
Note
データを取得できない場合、例外はスローされません。 代わりに、 false
が返されます。
こちらもご覧ください
適用対象
GetDataPresent(String, Boolean)
指定した形式のデータがこの DataObject に含まれているかどうかを確認し、オプションで、指定した形式に変換できるデータが含まれているかどうかも確認します。
public:
virtual bool GetDataPresent(System::String ^ format, bool autoConvert);
public virtual bool GetDataPresent (string format, bool autoConvert);
abstract member GetDataPresent : string * bool -> bool
override this.GetDataPresent : string * bool -> bool
Public Overridable Function GetDataPresent (format As String, autoConvert As Boolean) As Boolean
パラメーター
- format
- String
チェック対象となる形式。 定義済みの形式については、DataFormats のトピックを参照してください。
- autoConvert
- Boolean
この DataObject に格納されているデータを指定した形式に変換できるかどうかを確認する場合は true
。データが指定した形式かどうかを確認する場合は false
。
戻り値
データが指定した形式である場合や、その形式に変換できる場合は true
。それ以外の場合は false
。
実装
例
次のコード例では、 に現在格納されているデータが指定した形式に DataObject 関連付けられているかどうかを判断します。 最初に、新 DataObject しい が文字列で初期化され、その書式がテキストとして指定されます。
次に、 DataObject パラメーターを としてfalse
指定して、テキスト形式に関連付けられたデータに対して クエリがautoConvert
実行されます。 このクエリの結果はテキスト ボックスに出力されます。
次に、 DataObject パラメーターを としてtrue
指定して、文字列形式に関連付けられたデータに対して クエリがautoConvert
実行されます。 結果はテキスト ボックスに出力されます。 このコードでは、 が textBox1
作成されている必要があります。
private:
void GetIfPresent3()
{
// Creates a new data object using a string and the text format.
DataObject^ myDataObject = gcnew DataObject( DataFormats::Text, "Another string" );
// Prints the string in a text box with autoconvert = false.
if ( myDataObject->GetDataPresent( "System.String", false ) )
{
// Prints the string in a text box.
textBox1->Text = String::Concat(
myDataObject->GetData( "System.String", false )->ToString(), "\n" );
}
else
{
textBox1->Text = "Could not convert data to specified format\n";
}
// Prints the string in a text box with autoconvert = true.
textBox1->Text = String::Concat( textBox1->Text,
"With autoconvert = true, you can convert text to string format. String is: ",
myDataObject->GetData( "System.String", true )->ToString() );
}
private void GetIfPresent3() {
// Creates a new data object using a string and the text format.
DataObject myDataObject = new DataObject(DataFormats.Text, "Another string");
// Prints the string in a text box with autoconvert = false.
if(myDataObject.GetDataPresent("System.String", false)) {
// Prints the string in a text box.
textBox1.Text = myDataObject.GetData("System.String", false).ToString() + '\n';
} else
{
textBox1.Text = "Could not convert data to specified format" + '\n';
}
// Prints the string in a text box with autoconvert = true.
textBox1.Text += "With autoconvert = true, you can convert text to string format. " +
"String is: " + myDataObject.GetData("System.String", true).ToString();
}
Private Sub GetIfPresent3()
' Creates a new data object using a string and the text format.
Dim myDataObject As New DataObject(DataFormats.Text, "Another string")
' Prints the string in a text box with autoconvert = false.
If myDataObject.GetDataPresent("System.String", False) Then
' Prints the string in a text box.
textBox1.Text = myDataObject.GetData("System.String", False).ToString() & ControlChars.Cr
Else
textBox1.Text = "Could not convert data to specified format" & ControlChars.Cr
End If
' Prints the string in a text box with autoconvert = true.
textBox1.Text &= "With autoconvert = true, you can convert text to string format. " & _
"String is: " & myDataObject.GetData("System.String", True).ToString()
End Sub
注釈
を呼び出す前に形式が存在するかどうかを確認するには、このメソッドを呼び出します GetData。 この DataObjectで使用できる形式を呼び出GetFormatsします。
このメソッドは、次の場合にを返します true
。
パラメーターは
autoConvert
でありtrue
、データは適切な形式に変換できる形式です。パラメーターは
autoConvert
でfalse
、データは適切な形式です。
このメソッドは、次の場合にを返します false
。
パラメーターは
autoConvert
でありtrue
、このメソッドは指定した形式のデータを見つけることができません。また、指定した形式にデータを変換することも、自動変換を に設定してfalse
データを格納することもできません。パラメーターは
autoConvert
でありfalse
、指定された形式でデータが存在 DataObject しません。
Note
データは、その変換が許可されていることを指定して格納されている場合、および要求された形式が格納された形式と互換性がある場合は、別の形式に変換できます。 たとえば、Unicode として格納されているデータをテキストに変換できます。
注意
データを取得できない場合、例外はスローされません。 代わりに、 false
が返されます。
こちらもご覧ください
適用対象
.NET