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

true この DataObject に格納されているデータが、指定された形式に関連付けられているか、または変換できる場合。それ以外の場合は、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

true この DataObject に格納されているデータが、指定された形式に関連付けられているか、または変換できる場合。それ以外の場合は、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 を呼び出します。

手記

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

手記

データを取得できない場合、例外はスローされません。 代わりに、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 がテキスト形式に関連付けられているデータを照会し、autoConvert パラメーターを falseとして指定します。 このクエリの結果はテキスト ボックスに出力されます。

次に、DataObject が文字列形式に関連付けられたデータを照会し、autoConvert パラメーターを trueとして指定します。 結果がテキスト ボックスに出力されます。 このコードでは、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 にデータが存在しません。

手記

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

手記

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

こちらもご覧ください

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