DataFormats Klasa

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Udostępnia staticwstępnie zdefiniowane Clipboard nazwy formatów. Użyj ich, aby zidentyfikować format danych przechowywanych w obiekcie IDataObject.

public ref class DataFormats

public ref class DataFormats abstract sealed

public class DataFormats

public static class DataFormats

type DataFormats = class

Public Class DataFormats

Dziedziczenie

Object

DataFormats

Przykłady

Poniższy przykład kodu tworzy nowy format danych o nazwie myFormat. Następnie kod tworzy, MyNewObject który przechowuje w obiekcie DataObject. Element DataObject jest kopiowany do pliku Clipboard.

Następnie element DataObject zostanie pobrany z obiektu Clipboard , a element MyNewObject zostanie odzyskany. Wartość elementu MyNewObject jest drukowana w polu tekstowym. Ten kod wymaga textBox1 utworzenia i umieszczenia go w formularzu.

#using <System.dll>
#using <System.Drawing.dll>
#using <System.Windows.Forms.dll>

using namespace System;
using namespace System::Windows::Forms;

// Creates a new type.

[Serializable]
public ref class MyNewObject: public Object
{
private:
   String^ myValue;

public:

   // Creates a default constructor for the class.
   MyNewObject()
   {
      myValue = "This is the value of the class";
   }


   property String^ MyObjectValue 
   {

      // Creates a property to retrieve or set the value.
      String^ get()
      {
         return myValue;
      }

      void set( String^ value )
      {
         myValue = value;
      }

   }

};

public ref class MyClass: public Form
{
protected:
   TextBox^ textBox1;

public:
   void MyClipboardMethod()
   {
      
      // Creates a new data format.
      DataFormats::Format^ myFormat = DataFormats::GetFormat( "myFormat" );
      
      /* Creates a new object and stores it in a DataObject using myFormat 
               * as the type of format. */
      MyNewObject^ myObject = gcnew MyNewObject;
      DataObject^ myDataObject = gcnew DataObject( myFormat->Name,myObject );
      
      // Copies myObject into the clipboard.
      Clipboard::SetDataObject( myDataObject );
      
      // Performs some processing steps.
      // Retrieves the data from the clipboard.
      IDataObject^ myRetrievedObject = Clipboard::GetDataObject();
      
      // Converts the IDataObject type to MyNewObject type. 
      MyNewObject^ myDereferencedObject = dynamic_cast<MyNewObject^>(myRetrievedObject->GetData( myFormat->Name ));
      
      // Prints the value of the Object in a textBox.
      textBox1->Text = myDereferencedObject->MyObjectValue;
   }

};

using System;
using System.Windows.Forms;

public class MyClass : Form {
    protected TextBox textBox1;
    
    public void MyClipboardMethod() {
       // Creates a new data format.
       DataFormats.Format myFormat = DataFormats.GetFormat("myFormat");
       
       /* Creates a new object and stores it in a DataObject using myFormat 
        * as the type of format. */
       MyNewObject myObject = new MyNewObject();
       DataObject myDataObject = new DataObject(myFormat.Name, myObject);
 
       // Copies myObject into the clipboard.
       Clipboard.SetDataObject(myDataObject);
 
       // Performs some processing steps.
 
       // Retrieves the data from the clipboard.
       IDataObject myRetrievedObject = Clipboard.GetDataObject();
 
       // Converts the IDataObject type to MyNewObject type. 
       MyNewObject myDereferencedObject = (MyNewObject)myRetrievedObject.GetData(myFormat.Name);
 
       // Prints the value of the Object in a textBox.
       textBox1.Text = myDereferencedObject.MyObjectValue;
    }
 }
 
 // Creates a new type.
 [Serializable]
 public class MyNewObject : Object {
    private string myValue;
 
    // Creates a default constructor for the class.
    public MyNewObject() {
       myValue = "This is the value of the class";
    }
 
    // Creates a property to retrieve or set the value.
    public string MyObjectValue {
       get {
          return myValue;
       }
       set {
          myValue = value;
       }
    }
 }

Option Explicit
Option Strict

Imports System.Windows.Forms

Public Class MyClass1
    Inherits Form
    Private textBox1 As TextBox

    Public Sub MyClipboardMethod()
        ' Creates a new data format.
        Dim myFormat As DataFormats.Format = _
            DataFormats.GetFormat("myFormat")
        
        ' Creates a new object and store it in a DataObject using myFormat 
        ' as the type of format. 
        Dim myObject As New MyNewObject()
        Dim myDataObject As New DataObject(myFormat.Name, myObject)
        
        ' Copies myObject into the clipboard.
        Clipboard.SetDataObject(myDataObject)
        
        ' Performs some processing steps.
        ' Retrieves the data from the clipboard.
        Dim myRetrievedObject As IDataObject = Clipboard.GetDataObject()
        
        ' Converts the IDataObject type to MyNewObject type. 
        Dim myDereferencedObject As MyNewObject = _
            CType(myRetrievedObject.GetData(myFormat.Name), MyNewObject)
        
        ' Print the value of the Object in a textBox.
        textBox1.Text = myDereferencedObject.MyObjectValue
    End Sub
End Class


' Creates a new type.
<Serializable()> Public Class MyNewObject
    Inherits Object
    Private myValue As String
    
    
    ' Creates a default constructor for the class.
    Public Sub New()
        myValue = "This is the value of the class"
    End Sub
    
    ' Creates a property to retrieve or set the value.
    
    Public Property MyObjectValue() As String
        Get
            Return myValue
        End Get
        Set
            myValue = value
        End Set
    End Property
End Class

Uwagi

Klasy IDataObject i DataObject używają static również listy formatów, aby określić typ danych pobranych z systemu Clipboardlub przesyłanych w operacji przeciągania i upuszczania.

Metoda GetFormat umożliwia:

• Pobierz wstępnie zdefiniowany DataFormats.Format obiekt dla nazwy formatu lub numeru identyfikatora.

• Dodaj nową parę nazwa/numer identyfikacyjny formatu do static listy w tej klasie i zarejestrować format w rejestrze Windows jako Clipboard format podczas przekazywania nazwy formatu.

Możesz pobrać Id liczbę lub format Name z odpowiedniej właściwości w wystąpieniu DataFormats.Format .

Pola

Bitmap	Określa format mapy bitowej Windows. To static pole jest tylko do odczytu.
CommaSeparatedValue	Określa format wartości rozdzielanych przecinkami (CSV), który jest typowym formatem wymiany używanym przez arkusze kalkulacyjne. Ten format nie jest używany bezpośrednio przez Windows Forms. To static pole jest tylko do odczytu.
Dib	Określa format mapy bitowej niezależnej od urządzenia (DIB) Windows. To static pole jest tylko do odczytu.
Dif	Określa format Windows Data Interchange (DIF), który Windows Forms nie jest używany bezpośrednio. To static pole jest tylko do odczytu.
EnhancedMetafile	Określa Windows rozszerzony format metapliku. To static pole jest tylko do odczytu.
FileDrop	Określa format upuszczania pliku Windows, który Windows Forms nie jest używany bezpośrednio. To static pole jest tylko do odczytu.
Html	Określa tekst w formacie Schowka HTML. To static pole jest tylko do odczytu.
Locale	Określa format kultury Windows, który Windows Forms nie jest używany bezpośrednio. To static pole jest tylko do odczytu.
MetafilePict	Określa format metapliku Windows, który Windows Forms nie jest używany bezpośrednio. To static pole jest tylko do odczytu.
OemText	Określa standardowy format tekstowy Windows producenta sprzętu oryginalnego (OEM). To static pole jest tylko do odczytu.
Palette	Określa format palety Windows. To static pole jest tylko do odczytu.
PenData	Określa format danych pióra Windows, który składa się z pociągnięć pióra do oprogramowania pisma ręcznego; Windows Forms nie używa tego formatu. To static pole jest tylko do odczytu.
Riff	Określa format audio formatu pliku wymiany zasobów (RIFF), który Windows Forms nie jest używany bezpośrednio. To static pole jest tylko do odczytu.
Rtf	Określa tekst składający się z danych RTF (Rich Text Format). To static pole jest tylko do odczytu.
Serializable	Określa format hermetyzujący dowolny typ obiektu Windows Forms. To static pole jest tylko do odczytu.
StringFormat	Określa format klasy ciągów Windows Forms, który Windows Forms używa do przechowywania obiektów ciągów. To static pole jest tylko do odczytu.
SymbolicLink	Określa format linku symbolicznego Windows, który Windows Forms nie jest używany bezpośrednio. To static pole jest tylko do odczytu.
Text	Określa standardowy format tekstu ANSI. To static pole jest tylko do odczytu.
Tiff	Określa format otagowanych plików obrazów (TIFF), który Windows Forms nie jest używany bezpośrednio. To static pole jest tylko do odczytu.
UnicodeText	Określa standardowy format tekstu Windows Unicode. To static pole jest tylko do odczytu.
WaveAudio	Określa format dźwięku falowego, który Windows Forms nie jest używany bezpośrednio. To static pole jest tylko do odczytu.

Metody

GetFormat(Int32)	Zwraca element DataFormats.Format z identyfikatorem liczbowym Windows Schowka i nazwą dla określonego identyfikatora.
GetFormat(String)	Zwraca obiekt DataFormats.Format z identyfikatorem liczbowym Windows Schowka i nazwą dla określonego formatu.

Zobacz też

• Clipboard
• DataObject
• DataFormats.Format
• IDataObject
• SetData(String, Boolean, Object)
• GetData(String, Boolean)
• GetFormats(Boolean)
• GetDataPresent(Type)
• GetData(String, Boolean)
• GetDataPresent(String, Boolean)
• GetFormats(Boolean)
• SetData(String, Boolean, Object)