DataObject.GetData 메서드

정의

지정된 데이터 형식과 관련된 데이터를 반환합니다.Returns the data associated with the specified data format.

오버로드

GetData(String, Boolean)

자동 변환 매개 변수를 사용해서 데이터를 해당 형식으로 변환할지 여부를 결정하고 지정된 데이터 형식과 관련된 데이터를 반환합니다.Returns the data associated with the specified data format, using an automated conversion parameter to determine whether to convert the data to the format.

GetData(String)

지정된 데이터 형식과 관련된 데이터를 반환합니다.Returns the data associated with the specified data format.

GetData(Type)

지정된 클래스 형식과 관련된 데이터를 반환합니다.Returns the data associated with the specified class type format.

GetData(String, Boolean)

자동 변환 매개 변수를 사용해서 데이터를 해당 형식으로 변환할지 여부를 결정하고 지정된 데이터 형식과 관련된 데이터를 반환합니다.Returns the data associated with the specified data format, using an automated conversion parameter to determine whether to convert the data to the format.

public:
 virtual System::Object ^ GetData(System::String ^ format, bool autoConvert);
public virtual object GetData (string format, bool autoConvert);
abstract member GetData : string * bool -> obj
override this.GetData : string * bool -> obj
Public Overridable Function GetData (format As String, autoConvert As Boolean) As Object

매개 변수

format
String

검색할 데이터의 형식입니다.The format of the data to retrieve. 미리 정의된 형식에 대한 자세한 내용은 DataFormats를 참조하십시오.See DataFormats for predefined formats.

autoConvert
Boolean

데이터를 지정된 형식으로 변환하려면 true이고, 그렇지 않으면 false입니다.true to the convert data to the specified format; otherwise, false.

반환

지정된 형식과 관련된 데이터 또는 null입니다.The data associated with the specified format, or null.

구현

예제

다음 코드 예제에서는 autoConvert 매개 변수를 사용 하 여 데이터 형식을 변환할지 여부를 지정 하는 DataObject에 저장 된 데이터를 검색 합니다.The following code example retrieves the data stored in a DataObject, using the autoConvert parameter to specify whether to convert the data format.

먼저 텍스트 데이터를 사용 하 여 새 DataObject을 만듭니다.First, a new DataObject is created with text data. 그런 다음이 예제에서는 데이터를 검색 하 여 형식을 문자열로 지정 하 고 형식 변환을 시도 하지 않습니다. 즉, autoConvert 매개 변수가 false됩니다.Then the example tries to retrieve the data, specifying its format as a string and no format conversion, that is, the autoConvert parameter is false. DataObject에 문자열 데이터가 없으므로이 작업이 실패 합니다.This operation fails because there is no string data in the DataObject.

그런 다음이 예제에서는 autoConvert 매개 변수를 true으로 설정 하 여 데이터를 다시 검색 하려고 시도 합니다.Next, the example tries to retrieve the data again, with the autoConvert parameter set to true. 이 작업이 성공 하 고 결과가 MessageBox표시 됩니다.This operation succeeds and the results are displayed in a MessageBox.

이 코드를 실행 하려면 textBox1 만들었습니다.This code requires that textBox1 has been created.

private:
   void GetMyData3()
   {
      // Creates a new data object using a string and the text format.
      String^ myString = "My new text string";
      DataObject^ myDataObject = gcnew DataObject( DataFormats::Text,myString );
      
      // Prints the string in a text box with autoconvert = false.
      if ( myDataObject->GetData( "System.String", false ) != 0 )
      {
         // Prints the string in a text box.
         textBox1->Text = String::Concat(
            myDataObject->GetData( "System.String", false )->ToString(), "\n" );
      }
      else
      {
         textBox1->Text = "Could not find data of the specified format\n";
      }
      
      // Prints the string in a text box with autoconvert = true.
      textBox1->Text = String::Concat(
            textBox1->Text, myDataObject->GetData( "System.String", true )->ToString() );
   }
private void GetMyData3() {
    // Creates a new data object using a string and the text format.
    string myString = "My new text string";
    DataObject myDataObject = new DataObject(DataFormats.Text, myString);
 
    // Prints the string in a text box with autoconvert = false.
    if(myDataObject.GetData("System.String", false) != null) {
       // Prints the string in a text box.
       textBox1.Text = myDataObject.GetData("System.String", false).ToString() + '\n';
    } else
       textBox1.Text = "Could not find data of the specified format" + '\n';
 
    // Prints the string in a text box with autoconvert = true.
    textBox1.Text += myDataObject.GetData("System.String", true).ToString();
 }
 
Private Sub GetMyData3()
    ' Creates a new data object using a string and the text format.
    Dim myString As String = "My new text string"
    Dim myDataObject As New DataObject(DataFormats.Text, myString)
    
    ' Prints the string in a text box with autoconvert = false.
    If (myDataObject.GetData("System.String", False) IsNot Nothing) Then
        ' Prints the string in a text box.
        textBox1.Text = myDataObject.GetData("System.String", False).ToString() & ControlChars.Cr
    Else
        textBox1.Text = "Could not find data of the specified format" & ControlChars.Cr
    End If 
    ' Prints the string in a text box with autoconvert = true.
    textBox1.Text += myDataObject.GetData("System.String", True).ToString()
End Sub

설명

autoConvert 매개 변수가 true이 메서드는 지정 된 형식의 데이터를 찾을 수 없는 경우 데이터를 형식으로 변환 하려고 합니다.If the autoConvert parameter is true and this method cannot find data in the specified format, it attempts to convert the data to the format. 데이터를 지정 된 형식으로 변환할 수 없거나 자동 변환이 false로 설정 된 상태에서 데이터가 저장 된 경우이 메서드는 null반환 합니다.If the data cannot be converted to the specified format, or if the data was stored with the automatic conversion set to false, this method returns null.

autoConvert 매개 변수가 false인 경우이 메서드는 지정 된 형식의 데이터를 반환 하거나이 형식의 데이터를 찾을 수 없는 경우 null 합니다.If the autoConvert parameter is false, this method returns data in the specified format, or null if no data in this format can be found.

데이터를 형식으로 연결 하거나 형식으로 변환할 수 있는지 여부를 확인 하려면 GetData를 호출 하기 전에 GetDataPresent 합니다.To determine whether data is associated with, or can be converted to, a format, call GetDataPresent before calling GetData. DataObject에 저장 된 데이터에 대 한 유효한 형식 목록을 보려면 GetFormats를 호출 합니다.Call GetFormats for a list of valid formats for the data stored 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. 예를 들어 유니코드로 저장 된 데이터를 텍스트로 변환할 수 있습니다.For example, data stored as Unicode can be converted to text.

formatHtml,이 메서드는.NET 4.5 이상을 대상으로 하는 애플리케이션에서 u t F-8로 인코딩된 문자열을 반환 합니다. 및 ANSI로 인코딩된 문자열 애플리케이션에서.NET 4.0 또는 낮은 대상으로 하는 합니다.When format is Html, this method returns a UTF-8 encoded string in applications that target .NET 4.5 or higher, and an ANSI encoded string in applications that target .NET 4.0 or lower.

추가 정보

GetData(String)

지정된 데이터 형식과 관련된 데이터를 반환합니다.Returns the data associated with the specified data format.

public:
 virtual System::Object ^ GetData(System::String ^ format);
public virtual object GetData (string format);
abstract member GetData : string -> obj
override this.GetData : string -> obj
Public Overridable Function GetData (format As String) As Object

매개 변수

format
String

검색할 데이터의 형식입니다.The format of the data to retrieve. 미리 정의된 형식에 대한 자세한 내용은 DataFormats를 참조하십시오.See DataFormats for predefined formats.

반환

지정된 형식과 관련된 데이터 또는 null입니다.The data associated with the specified format, or null.

구현

예제

다음 코드 예에서는 DataObject에 저장 된 데이터를 검색 합니다.The following code example retrieves the data stored in a DataObject. 먼저 텍스트 데이터를 사용 하 여 새 DataObject을 만듭니다.First, a new DataObject is created with text data. 그런 다음 데이터를 검색 하 여 해당 형식을 문자열로 지정 하 고 텍스트 상자에 표시 합니다.Then, the data is retrieved, specifying its format as a string, and displayed in a text box.

이 코드를 실행 하려면 textBox1 만들었습니다.This code requires that textBox1 has been created.

private:
   void AddMyData3()
   {
      // Creates a component to store in the data object.
      Component^ myComponent = gcnew Component;
      
      // Creates a new data object.
      DataObject^ myDataObject = gcnew DataObject;
      
      // Adds the component to the DataObject.
      myDataObject->SetData( myComponent );
      
      // Prints whether data of the specified type is in the DataObject.
      Type^ myType = myComponent->GetType();
      if ( myDataObject->GetDataPresent( myType ) )
      {
         textBox1->Text = String::Concat( "Data of type ", myType,
            " is present in the DataObject" );
      }
      else
      {
         textBox1->Text = String::Concat( "Data of type ", myType,
            " is not present in the DataObject" );
      }
   }
private void AddMyData3() {
    // Creates a component to store in the data object.
    Component myComponent = new Component();
 
    // Creates a new data object.
    DataObject myDataObject = new DataObject();
 
    // Adds the component to the DataObject.
    myDataObject.SetData(myComponent);
 
    // Prints whether data of the specified type is in the DataObject.
    Type myType = myComponent.GetType();
    if(myDataObject.GetDataPresent(myType))
       textBox1.Text = "Data of type " + myType.ToString() + 
       " is present in the DataObject";
    else
       textBox1.Text = "Data of type " + myType.ToString() +
       " is not present in the DataObject";
 }
Private Sub AddMyData3()
    ' Creates a component to store in the data object.
    Dim myComponent As New Component()
    
    ' Creates a new data object.
    Dim myDataObject As New DataObject()
    
    ' Adds the component to the DataObject.
    myDataObject.SetData(myComponent)
    
    ' Prints whether data of the specified type is in the DataObject.
    Dim myType As Type = myComponent.GetType()
    If myDataObject.GetDataPresent(myType) Then
        textBox1.Text = "Data of type " & myType.ToString() & _
            " is present in the DataObject"
    Else
        textBox1.Text = "Data of type " & myType.ToString() & _
            " is not present in the DataObject"
    End If
End Sub

설명

이 메서드가 지정 된 형식으로 데이터를 찾을 수 없는 경우 데이터를 형식으로 변환 하려고 합니다.If this method cannot find data in the specified format, it attempts to convert the data to the format. 데이터를 지정 된 형식으로 변환할 수 없거나 자동 변환으로 데이터가 false로 설정 된 경우이 메서드는 null반환 합니다.If the data cannot be converted to the specified format, or if the data was stored with automatic conversion set to false, this method returns null.

데이터를 형식으로 연결 하거나 형식으로 변환할 수 있는지 여부를 확인 하려면 GetData를 호출 하기 전에 GetDataPresent 합니다.To determine whether data is associated with, or can be converted to, a format, call GetDataPresent before calling GetData. DataObject에 저장 된 데이터에 대 한 유효한 형식 목록을 보려면 GetFormats를 호출 합니다.Call GetFormats for a list of valid formats for the data stored 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. 예를 들어 유니코드로 저장 된 데이터를 텍스트로 변환할 수 있습니다.For example, data stored as Unicode can be converted to text.

formatHtml,이 메서드는.NET 4.5 이상을 대상으로 하는 애플리케이션에서 u t F-8로 인코딩된 문자열을 반환 합니다. 및 ANSI로 인코딩된 문자열 애플리케이션에서.NET 4.0 또는 낮은 대상으로 하는 합니다.When format is Html, this method returns a UTF-8 encoded string in applications that target .NET 4.5 or higher, and an ANSI encoded string in applications that target .NET 4.0 or lower.

추가 정보

GetData(Type)

지정된 클래스 형식과 관련된 데이터를 반환합니다.Returns the data associated with the specified class type format.

public:
 virtual System::Object ^ GetData(Type ^ format);
public virtual object GetData (Type format);
abstract member GetData : Type -> obj
override this.GetData : Type -> obj
Public Overridable Function GetData (format As Type) As Object

매개 변수

format
Type

검색할 데이터의 형식을 나타내는 Type입니다.A Type representing the format of the data to retrieve.

반환

지정된 형식과 관련된 데이터 또는 null입니다.The data associated with the specified format, or null.

구현

예제

다음 코드 예에서는 DataObject에 저장 된 데이터를 검색 합니다.The following code example retrieves the data stored in a DataObject. 먼저 새 DataObject 구성 요소를 사용 하 여 만들어집니다.First, a new DataObject is created with a component. 그런 다음 데이터를 검색 하 여 해당 형식을 지정 합니다.Then, the data is retrieved, specifying its type. 검색 된 데이터의 형식이 텍스트 상자에 표시 됩니다.The type of the retrieved data is displayed in a text box.

이 코드를 실행 하려면 textBox1 만들었습니다.This code requires that textBox1 has been created.

private:
   void GetMyData()
   {
      // 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();
      
      // Retrieves the data using myType to represent its type.
      Object^ myObject = myDataObject->GetData( myType );
      if ( myObject != nullptr )
      {
         textBox1->Text = String::Format( "The data type stored in the DataObject is: {0}",
            myObject->GetType()->Name );
      }
      else
      {
         textBox1->Text = "Data of the specified type was not stored in the DataObject.";
      }
   }
private void GetMyData() {
    // 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();
 
    // Retrieves the data using myType to represent its type.
    Object myObject = myDataObject.GetData(myType);
    if(myObject != null)
       textBox1.Text = "The data type stored in the DataObject is: " +
       myObject.GetType().Name;
    else
       textBox1.Text = "Data of the specified type was not stored " +
       "in the DataObject.";
 }
 
Private Sub GetMyData()
    ' 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()
    
    ' Retrieves the data using myType to represent its type.
    Dim myObject As Object = myDataObject.GetData(myType)
    If (myObject IsNot Nothing) Then
        textBox1.Text = "The data type stored in the DataObject is: " & myObject.GetType().Name
    Else
        textBox1.Text = "Data of the specified type was not stored " & "in the DataObject."
    End If
End Sub

설명

이 메서드가 지정 된 형식으로 데이터를 찾을 수 없는 경우 데이터를 형식으로 변환 하려고 합니다.If this method cannot find data in the specified format, it attempts to convert the data to the format. 데이터를 지정 된 형식으로 변환할 수 없거나 자동 변환으로 데이터가 false로 설정 된 경우이 메서드는 null반환 합니다.If the data cannot be converted to the specified format, or if the data was stored with automatic conversion set to false, this method returns null.

데이터를 형식으로 연결 하거나 형식으로 변환할 수 있는지 여부를 확인 하려면 GetData를 호출 하기 전에 GetDataPresent 합니다.To determine whether data is associated with, or can be converted to, a format, call GetDataPresent before calling GetData. DataObject에 저장 된 데이터에 대 한 유효한 형식 목록을 보려면 GetFormats를 호출 합니다.Call GetFormats for a list of valid formats for the data stored 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. 예를 들어 유니코드로 저장 된 데이터를 텍스트로 변환할 수 있습니다.For example, data stored as Unicode can be converted to text.

추가 정보

적용 대상