DataObject.SetData 메서드

정의

DataObject에 개체를 추가합니다.Adds an object to the DataObject.

오버로드

SetData(Object)

개체 형식을 데이터 형식으로 사용하여 DataObject에 지정된 개체를 추가합니다.Adds the specified object to the DataObject using the object type as the data format.

SetData(String, Object)

지정된 형식을 사용하여 DataObject에 지정된 개체를 추가합니다.Adds the specified object to the DataObject using the specified format.

SetData(Type, Object)

지정된 형식을 형식으로 사용하여 DataObject에 지정된 개체를 추가합니다.Adds the specified object to the DataObject using the specified type as the format.

SetData(String, Boolean, Object)

지정된 형식을 사용하고 데이터가 다른 형식으로 변환될 수 있는지 여부를 나타내어 DataObject에 지정된 개체를 추가합니다.Adds the specified object to the DataObject using the specified format and indicating whether the data can be converted to another format.

SetData(Object)

개체 형식을 데이터 형식으로 사용하여 DataObject에 지정된 개체를 추가합니다.Adds the specified object to the DataObject using the object type as the data format.

public:
 virtual void SetData(System::Object ^ data);
public virtual void SetData (object data);
abstract member SetData : obj -> unit
override this.SetData : obj -> unit
Public Overridable Sub SetData (data As Object)

매개 변수

data
Object

저장할 데이터입니다.The data to store.

구현

예제

다음 코드 예제에서는 DataObject에 데이터를 저장 합니다.The following code example stores data in a DataObject. 먼저 새 DataObject 만들어지고 구성 요소가 저장 됩니다.First, a new DataObject is created and a component is stored in it. 그런 다음 클래스를 지정 하 여 데이터를 검색 합니다.Then, the data is retrieved by specifying the class. 결과 텍스트 상자에 표시 됩니다.The result is 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->Name,
           " is present in the DataObject" );
      }
      else
      {
         textBox1->Text = String::Concat( "Data of type ", myType->Name,
           " 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.GetType().Name + 
       " is present in the DataObject";
    else
       textBox1.Text = "Data of type " + myType.GetType().Name +
       " 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.GetType().Name & _
            " is present in the DataObject"
    Else
        textBox1.Text = "Data of type " & myType.GetType().Name & _
            " is not present in the DataObject"
    End If
End Sub

설명

중요

신뢰할 수 없는 데이터로 이 메서드를 호출하는 것은 보안상 위험합니다.Calling this method with untrusted data is a security risk. 신뢰할 수 있는 데이터로만 이 메서드를 호출하세요.Call this method only with trusted data. 자세한 내용은 데이터 유효성을 참조하세요.For more information, see Data Validation.

대상 애플리케이션의 형식을 모르는 경우이 메서드를 사용 하 여 여러 형식의 데이터를 저장할 수 있습니다.If you do not know the format of the target application, you can store data in multiple formats using this method. 이 메서드를 사용 하 여 저장 된 데이터는 검색 시 호환 되는 형식으로 변환할 수 있습니다.Data stored using this method can be converted to a compatible format when it is retrieved.

SetData(Object) 오버 로드는 Object.GetType 메서드를 호출 하 여 확인 하는 형식으로 data 값을 저장 합니다.The SetData(Object) overload stores the data value in a format that it determines by calling the Object.GetType method. data ISerializable 인터페이스를 구현 하는 경우이 오버 로드도 값을 Serializable 형식으로 저장 합니다.If data implements the ISerializable interface, this overload also stores the value in the Serializable format.

추가 정보

SetData(String, Object)

지정된 형식을 사용하여 DataObject에 지정된 개체를 추가합니다.Adds the specified object to the DataObject using the specified format.

public:
 virtual void SetData(System::String ^ format, System::Object ^ data);
public virtual void SetData (string format, object data);
abstract member SetData : string * obj -> unit
override this.SetData : string * obj -> unit
Public Overridable Sub SetData (format As String, data As Object)

매개 변수

format
String

데이터와 관련된 형식입니다.The format associated with the data. 미리 정의된 형식에 대한 자세한 내용은 DataFormats를 참조하십시오.See DataFormats for predefined formats.

data
Object

저장할 데이터입니다.The data to store.

구현

예제

다음 코드 예에서는 데이터 형식을 유니코드로 지정 하 여 DataObject에 데이터를 저장 합니다.The following code example stores data in a DataObject, specifying its format as Unicode.

그런 다음 텍스트 형식을 지정 하 여 데이터를 검색 합니다. 기본값은 최종 형식이 호환 되는 경우 데이터를 변환 하는 것 이기 때문입니다.Then the data is retrieved by specifying the text format, since the default is to convert the data when the final format is compatible. 결과 텍스트 상자에 표시 됩니다.The result is displayed in a text box.

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

private:
   void AddMyData()
   {
      // Creates a new data object using a string and the text format.
      DataObject^ myDataObject = gcnew DataObject;
      
      // Stores a string, specifying the Unicode format.
      myDataObject->SetData( DataFormats::UnicodeText, "Text string" );
      
      // Retrieves the data by specifying Text.
      textBox1->Text = myDataObject->GetData( DataFormats::Text )->GetType()->Name;
   }
private void AddMyData() {
    // Creates a new data object using a string and the text format.
    DataObject myDataObject = new DataObject();
 
    // Stores a string, specifying the Unicode format.
    myDataObject.SetData(DataFormats.UnicodeText, "Text string");
 
    // Retrieves the data by specifying Text.
    textBox1.Text = myDataObject.GetData(DataFormats.Text).GetType().Name;
 }
 
Private Sub AddMyData()
    ' Creates a new data object using a string and the text format.
    Dim myDataObject As New DataObject()
    
    ' Stores a string, specifying the Unicode format.
    myDataObject.SetData(DataFormats.UnicodeText, "Text string")
    
    ' Retrieves the data by specifying Text.
    textBox1.Text = myDataObject.GetData(DataFormats.Text).GetType().Name
End Sub

설명

중요

신뢰할 수 없는 데이터로 이 메서드를 호출하는 것은 보안상 위험합니다.Calling this method with untrusted data is a security risk. 신뢰할 수 있는 데이터로만 이 메서드를 호출하세요.Call this method only with trusted data. 자세한 내용은 데이터 유효성을 참조하세요.For more information, see Data Validation.

대상 애플리케이션의 형식을 모르는 경우이 메서드를 사용 하 여 여러 형식의 데이터를 저장할 수 있습니다.If you do not know the format of the target application, you can store data in multiple formats using this method.

이 메서드를 사용 하 여 저장 된 데이터는 검색 시 호환 되는 형식으로 변환할 수 있습니다.Data stored using this method can be converted to a compatible format when it is retrieved.

추가 정보

SetData(Type, Object)

지정된 형식을 형식으로 사용하여 DataObject에 지정된 개체를 추가합니다.Adds the specified object to the DataObject using the specified type as the format.

public:
 virtual void SetData(Type ^ format, System::Object ^ data);
public virtual void SetData (Type format, object data);
abstract member SetData : Type * obj -> unit
override this.SetData : Type * obj -> unit
Public Overridable Sub SetData (format As Type, data As Object)

매개 변수

format
Type

데이터와 관련된 형식을 나타내는 Type입니다.A Type representing the format associated with the data.

data
Object

저장할 데이터입니다.The data to store.

구현

예제

다음 코드 예에서는 Type를 데이터 형식으로 사용 하 여 DataObject에 데이터를 저장 합니다.The following code example stores data in a DataObject using a Type as the data format. 그런 다음 Type를 사용 하 여 데이터 형식을 지정 하는 GetData를 호출 하 여 데이터를 검색 합니다.The data is then retrieved by calling GetData using the Type to specify the data format. 결과 텍스트 상자에 표시 됩니다.The result is displayed in a text box.

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

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

설명

중요

신뢰할 수 없는 데이터로 이 메서드를 호출하는 것은 보안상 위험합니다.Calling this method with untrusted data is a security risk. 신뢰할 수 있는 데이터로만 이 메서드를 호출하세요.Call this method only with trusted data. 자세한 내용은 데이터 유효성을 참조하세요.For more information, see Data Validation.

대상 애플리케이션의 형식을 모르는 경우이 메서드를 사용 하 여 여러 형식의 데이터를 저장할 수 있습니다.If you do not know the format of the target application, you can store data in multiple formats using this method.

이 메서드를 사용 하 여 저장 된 데이터는 검색 시 호환 되는 형식으로 변환할 수 있습니다.Data stored using this method can be converted to a compatible format when it is retrieved.

추가 정보

SetData(String, Boolean, Object)

지정된 형식을 사용하고 데이터가 다른 형식으로 변환될 수 있는지 여부를 나타내어 DataObject에 지정된 개체를 추가합니다.Adds the specified object to the DataObject using the specified format and indicating whether the data can be converted to another format.

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

매개 변수

format
String

데이터와 관련된 형식입니다.The format associated with the data. 미리 정의된 형식에 대한 자세한 내용은 DataFormats를 참조하십시오.See DataFormats for predefined formats.

autoConvert
Boolean

데이터를 다른 형식으로 변환할 수 있도록 하려면 true이고, 그렇지 않으면 false입니다.true to allow the data to be converted to another format; otherwise, false.

data
Object

저장할 데이터입니다.The data to store.

구현

예제

다음 코드 예제에서는 DataObject에 데이터를 저장 하 고 데이터를 네이티브 형식 으로만 검색할 수 있도록 지정 합니다.The following code example stores data in a DataObject and specifies that the data can only be retrieved in its native format.

먼저 새 DataObject 만들어집니다.First, a new DataObject is created. 유니코드 형식의 데이터는 autoConvert false으로 설정 된 DataObject에 저장 됩니다.Data in the Unicode format is stored in the DataObject, with autoConvert set to false.

그런 다음 사용 가능한 데이터 형식 목록에 대해 DataObject를 쿼리 합니다.Then, the DataObject is queried for the list of available data formats. 유니코드 데이터는 텍스트 및 다른 형식으로 변환할 수 있지만 유니코드 형식만 반환 됩니다.Only the Unicode format is returned, although Unicode data can be converted to text and other formats.

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

private:
   void AddMyData4()
   {
      // Creates a new data object, and assigns it the component.
      DataObject^ myDataObject = gcnew DataObject;
      
      // Adds data to the DataObject, and specifies no format conversion.
      myDataObject->SetData( DataFormats::UnicodeText, false, "My Unicode data" );
      
      // Gets the data formats in the DataObject.
      array<String^>^ arrayOfFormats = myDataObject->GetFormats();
      
      // Prints the results.
      textBox1->Text = "The format(s) associated with the data are: \n";
      for ( int i = 0; i < arrayOfFormats->Length; i++ )
      {
         textBox1->Text = String::Concat( textBox1->Text, arrayOfFormats[ i ], "\n" );
      }
   }
private void AddMyData4() {
    // Creates a new data object, and assigns it the component.
    DataObject myDataObject = new DataObject();
 
    // Adds data to the DataObject, and specifies no format conversion.
    myDataObject.SetData(DataFormats.UnicodeText, false, "My Unicode data");
 
    // Gets the data formats in the DataObject.
    String[] arrayOfFormats = myDataObject.GetFormats();
 
    // Prints the results.
    textBox1.Text = "The format(s) associated with the data are: " + '\n';
    for(int i=0; i<arrayOfFormats.Length; i++)
       textBox1.Text += arrayOfFormats[i] + '\n';
 }
 
Private Sub AddMyData4()
    ' Creates a new data object, and assigns it the component.
    Dim myDataObject As New DataObject()
    
    ' Adds data to the DataObject, and specifies no format conversion.
    myDataObject.SetData(DataFormats.UnicodeText, False, "My Unicode data")
    
    ' Gets the data formats in the DataObject.
    Dim arrayOfFormats As String() = myDataObject.GetFormats()
    
    ' Prints the results.
    textBox1.Text = "The format(s) associated with the data are: " & ControlChars.Cr
    Dim i As Integer
    For i = 0 To arrayOfFormats.Length - 1
        textBox1.Text += arrayOfFormats(i) & ControlChars.Cr
    Next i
End Sub

설명

중요

신뢰할 수 없는 데이터로 이 메서드를 호출하는 것은 보안상 위험합니다.Calling this method with untrusted data is a security risk. 신뢰할 수 있는 데이터로만 이 메서드를 호출하세요.Call this method only with trusted data. 자세한 내용은 데이터 유효성을 참조하세요.For more information, see Data Validation.

대상 애플리케이션의 형식을 모르는 경우이 메서드를 사용 하 여 여러 형식의 데이터를 저장할 수 있습니다.If you do not know the format of the target application, you can store data in multiple formats using this method.

추가 정보

적용 대상