DataObject.GetDataPresent メソッド

定義

名前空間:

System.Windows.Forms

アセンブリ:

System.Windows.Forms.dll

この 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 のトピックを参照してください。

戻り値

Boolean

この DataObject に格納されているデータが、指定されている形式に関連付けられている場合や、その形式に変換できる場合は true。それ以外の場合は false。

実装

GetDataPresent(String)

例

次のコード例では、現在この DataObject に格納されているデータが、指定した形式に関連付けられているか、またはに変換できるかを決定します。 新 DataObject しい は、文字列とそれに関連付けられた書式をテキストとして指定して初期化されます。

次に、テキスト データが に存在するかどうかを出力します DataObject。 このコードでは、 が textBox1 作成されている必要があります。

注釈

を呼び出す前に形式が存在するかどうかを確認するには、このメソッドを呼び出します GetData。 この DataObjectで使用できる形式を呼び出GetFormatsします。

注意

データは、その変換が許可されていることを指定して格納されている場合、および要求された形式が格納された形式と互換性がある場合は、別の形式に変換できます。 たとえば、Unicode として格納されているデータをテキストに変換できます。

注意

データを取得できない場合、例外はスローされません。 代わりに、 false が返されます。

こちらもご覧ください

• SetData(String, Boolean, Object)
• GetData(String, Boolean)
• DataFormats
• GetFormats(Boolean)

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

パラメーター

format

Type

チェック対象となる形式を表す Type。

戻り値

Boolean

この DataObject に格納されているデータが、指定されている形式に関連付けられている場合や、その形式に変換できる場合は true。それ以外の場合は false。

実装

GetDataPresent(Type)

例

次のコード例では、指定した型のデータが に 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 が返されます。

こちらもご覧ください

• SetData(String, Boolean, Object)
• GetData(String, Boolean)
• Type
• DataFormats
• GetFormats(Boolean)

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。

戻り値

Boolean

データが指定した形式である場合や、その形式に変換できる場合は true。それ以外の場合は false。

実装

GetDataPresent(String, Boolean)

例

次のコード例では、 に現在格納されているデータが指定した形式に 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 が返されます。

こちらもご覧ください

• SetData(String, Boolean, Object)
• GetData(String, Boolean)
• DataFormats
• GetFormats(Boolean)