DataObject.GetDataPresent メソッド

定義

この DataObject に格納されているデータが、指定した形式に関連付けられているかどうかを確認します。Determines whether data stored in this DataObject is associated with the specified format.

オーバーロード

GetDataPresent(String)

この DataObject に格納されているデータが、指定した形式と関連付けられているかどうかや、その形式に変換できるかどうかを確認します。Determines whether data stored in this DataObject is associated with, or can be converted to, the specified format.

GetDataPresent(Type)

この DataObject に格納されているデータが、指定した形式と関連付けられているかどうかや、その形式に変換できるかどうかを確認します。Determines whether data stored in this DataObject is associated with, or can be converted to, the specified format.

GetDataPresent(String, Boolean)

指定した形式のデータがこの DataObject に含まれているかどうかを確認し、オプションで、指定した形式に変換できるデータが含まれているかどうかも確認します。Determines whether this DataObject contains data in the specified format or, optionally, contains data that can be converted to the specified format.

GetDataPresent(String)

この DataObject に格納されているデータが、指定した形式と関連付けられているかどうかや、その形式に変換できるかどうかを確認します。Determines whether data stored in this DataObject is associated with, or can be converted to, the specified format.

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

チェック対象となる形式。The format to check for. 定義済みの形式については、DataFormats のトピックを参照してください。See DataFormats for predefined formats.

戻り値

Boolean

この DataObject に格納されているデータが、指定されている形式に関連付けられている場合や、その形式に変換できる場合は true。それ以外の場合は falsetrue if data stored in this DataObject is associated with, or can be converted to, the specified format; otherwise, false.

実装

次のコード例では、このに現在格納されているデータ DataObject が、指定した形式に関連付けられているか、または指定した形式に変換できるかを判断します。The following code example determines whether data currently stored in this DataObject is associated with, or can be converted to, a specified format. 新しい DataObject は、文字列とそれに関連付けられた形式でテキストとして初期化されます。A new DataObject is initialized with a string and its associated format specified as text.

この例では、テキストデータがに存在するかどうかを出力し DataObject ます。Then the examples prints whether text data exists in the DataObject. このコードで textBox1 は、が作成されている必要があります。This code requires that textBox1 has been created.

注釈

を呼び出す前に形式が存在するかどうかを確認するには、このメソッドを呼び出し GetData ます。Call this method to determine whether a format exists before calling GetData. GetFormatsこので使用可能な形式に対してを呼び出し DataObject ます。Call GetFormats for the formats that are available in this DataObject.

注意

変換が許可されているかどうか、および要求された形式が格納されている形式と互換性があるかどうかを指定するようにデータを格納している場合は、別の形式に変換できます。Data can be converted to another format if it was stored specifying that conversion is allowed, and if the requested format is compatible with the stored format. たとえば、Unicode として格納されているデータをテキストに変換できます。For example, data stored as Unicode can be converted to text.

注意

データを取得できない場合、例外はスローされません。If no data can be retrieved, no exception will be thrown. 代わりに false が返されます。Instead, false will be returned.

こちらもご覧ください

適用対象

GetDataPresent(Type)

この DataObject に格納されているデータが、指定した形式と関連付けられているかどうかや、その形式に変換できるかどうかを確認します。Determines whether data stored in this DataObject is associated with, or can be converted to, the specified format.

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

パラメーター

format
Type

チェック対象となる形式を表す TypeA Type representing the format to check for.

戻り値

Boolean

この DataObject に格納されているデータが、指定されている形式に関連付けられている場合や、その形式に変換できる場合は true。それ以外の場合は falsetrue if data stored in this DataObject is associated with, or can be converted to, the specified format; otherwise, false.

実装

次のコード例では、指定した型のデータがに存在するかどうか DataObject 、またはデータを指定した型に変換できるかどうかを判断します。The following code example determines whether data of the specified type exists in a DataObject, or whether the data can be converted to the specified type. 結果がテキストボックスに表示されます。The result is displayed in a text box. このコードで textBox1 は、が作成されている必要があります。The code requires that textBox1 has been created.

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 ます。Call this method to determine whether a format exists before calling GetData. GetFormatsこので使用可能な形式に対してを呼び出し DataObject ます。Call GetFormats for the formats that are available in this DataObject.

注意

変換が許可されているかどうか、および要求された形式が格納されている形式と互換性があるかどうかを指定するようにデータを格納している場合は、別の形式に変換できます。Data can be converted to another format if it was stored specifying that conversion is allowed, and if the requested format is compatible with the stored format. たとえば、Unicode として格納されているデータをテキストに変換できます。For example, data stored as Unicode can be converted to text.

注意

データを取得できない場合、例外はスローされません。If no data can be retrieved, no exception will be thrown. 代わりに false が返されます。Instead, false will be returned.

こちらもご覧ください

適用対象

GetDataPresent(String, Boolean)

指定した形式のデータがこの DataObject に含まれているかどうかを確認し、オプションで、指定した形式に変換できるデータが含まれているかどうかも確認します。Determines whether this DataObject contains data in the specified format or, optionally, contains data that can be converted to the specified format.

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

チェック対象となる形式。The format to check for. 定義済みの形式については、DataFormats のトピックを参照してください。See DataFormats for predefined formats.

autoConvert
Boolean

この DataObject に格納されているデータを指定した形式に変換できるかどうかを確認する場合は true。データが指定した形式かどうかを確認する場合は falsetrue to determine whether data stored in this DataObject can be converted to the specified format; false to check whether the data is in the specified format.

戻り値

Boolean

データが指定した形式である場合や、その形式に変換できる場合は true。それ以外の場合は falsetrue if the data is in, or can be converted to, the specified format; otherwise, false.

実装

次のコード例では、に現在格納されているデータが、指定した DataObject 形式に関連付けられているかどうかを判断します。The following code example determines whether data currently stored in the DataObject is associated with a specified format. まず、新しい DataObject が文字列で初期化され、その形式がテキストとして指定されます。First, a new DataObject is initialized with a string, specifying its format as text.

次に、パラメーターをとして指定して、 DataObject テキスト形式に関連付けられているデータに対してを照会し autoConvert false ます。Then the DataObject is queried for data associated with the text format, specifying the autoConvert parameter as false. このクエリの結果は、テキストボックスに出力されます。The result of this query is printed in a text box.

次に、パラメーターをとして指定して、 DataObject 文字列形式に関連付けられているデータを照会し autoConvert true ます。Then the DataObject is queried for data associated with string format, specifying the autoConvert parameter as true. 結果はテキストボックスに出力されます。The results are printed in the text box. このコードで textBox1 は、が作成されている必要があります。This code requires that textBox1 has been created.

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 ます。Call this method to determine whether a format exists before calling GetData. GetFormatsこので使用可能な形式に対してを呼び出し DataObject ます。Call GetFormats for the formats that are available in this DataObject.

このメソッド true は、次の場合にを返します。This method returns true when:

  • autoConvertパラメーターがで、 true データが適切な形式に変換できる形式です。The autoConvert parameter is true and the data is in a format that can be converted to the appropriate format.

  • autoConvertパラメーターがで、 false データが適切な形式である。The autoConvert parameter is false and the data is in the appropriate format.

このメソッド false は、次の場合にを返します。This method returns false when:

  • autoConvertパラメーターがで、 true このメソッドは指定された形式でデータを見つけることができません。また、データを指定された形式に変換できません。または、に自動変換が設定された状態でデータが格納されてい false ます。The autoConvert parameter is true and this method cannot find data in the specified format, and it cannot convert data to the specified format, or the data was stored with automatic conversion set to false.

  • autoConvertパラメーターがで、 false DataObject 指定された形式でデータがこの内に存在しません。The autoConvert parameter is false and data does not exist in this DataObject in the specified format.

注意

変換が許可されていて、要求された形式が格納された形式と互換性がある場合は、データを別の形式に変換できます。Data can be converted to another format if it was stored specifying that conversion is allowed and if the requested format is compatible with the stored format. たとえば、Unicode として格納されているデータをテキストに変換できます。For example, data stored as Unicode can be converted to text.

注意

データを取得できない場合、例外はスローされません。If no data can be retrieved, no exception will be thrown. 代わりに false が返されます。Instead, false will be returned.

こちらもご覧ください

適用対象