Interfejs IPersistFileFormat

Artykuł
08/10/2016

Opublikowano: sierpień 2016

Pobiera informacje o formacie pliku o elementach, które wymagają zapisywanie i umożliwia programowy ładowania lub zapisywania obiektu w formacie określonym przez użytkownika.

Przestrzeń nazw: Microsoft.VisualStudio.Shell.Interop
Zestaw: Microsoft.VisualStudio.Shell.Interop (w Microsoft.VisualStudio.Shell.Interop.dll)

Składnia

[GuidAttribute("3AFAE242-B530-11D0-8199-00A0C91BBEE3")]
[InterfaceTypeAttribute(1)]
public interface IPersistFileFormat : IPersist

[GuidAttribute("3AFAE242-B530-11D0-8199-00A0C91BBEE3")]
[InterfaceTypeAttribute(1)]
public interface class IPersistFileFormat : IPersist

[<GuidAttribute("3AFAE242-B530-11D0-8199-00A0C91BBEE3")>]
[<InterfaceTypeAttribute(1)>]
type IPersistFileFormat = 
    interface
        interface IPersist
    end

<GuidAttribute("3AFAE242-B530-11D0-8199-00A0C91BBEE3")>
<InterfaceTypeAttribute(1)>
Public Interface IPersistFileFormat
    Inherits IPersist

Metody

	Nazwa	Opis
	GetClassID(Guid)
	GetCurFile(String, UInt32)	Zwraca ścieżkę do pliku pracy bieżącego obiektu, lub, jeśli nie ma bieżącego pliku roboczego obiektu domyślnego pliku nazwa wiersza.
	GetFormatList(String)	Zapewnia obiekt wywołujący informacje potrzebne do otwierania standardowa wspólnej Zapisz jako okno dialogowe (przy użyciu GetSaveFileNameViaDlg funkcji) w imieniu obiektu.
	InitNew(UInt32)	Powoduje, że obiekt do zainicjowania w stanie bez nazwy.
	IsDirty(Int32)	Określa, czy obiekt został zmieniony od momentu jego bieżący plik zapisywany.
	Load(String, UInt32, Int32)	Otwiera określony plik i inicjuje obiekt z zawartości pliku.
	Save(String, Int32, UInt32)	Zapisuje kopię obiektu do określonego pliku.
	SaveCompleted(String)	Powiadamia obiektu została zawarta transakcji Zapisz i że obiekt może zapisywać do jego pliku.

Uwagi

IPersistFileFormat Interfejs jest oparty na standardzie IPersistFile interfejs i rozszerza ją w następujący sposób:

Pokazuje, jak prawidłowo określić nowy, bez nazwy pliku do InitNew metody.
Pokazuje, że plik powinien zostać otwarty jako tylko do odczytu pliku.
Eliminuje niepotrzebne Zapisz jako monit ciąg z GetCurFile.
Kod zwraca błąd, gdy Save(null) jest wywoływana bez nazwy obiektu.

IPersistFileFormat dostarcza wystarczająco dużo informacji klienta obiektu do zaimplementowania Zapisz jako okno dialogowe —, wypełnianie Zapisz jako typ listy rozwijanej listy i zarządzanie rozszerzenie pliku początkowej, ale nadal zapewniają elastyczność pełną do obiektu. W związku z tym obiektem jest właścicielem wszystkich aspektów jego plik i format, łącznie z nazwą jego format.

Uwagi dotyczące implementacji:

Podczas zapisywania dokumentów lub edytory dokumentu, które używają standardowego Zapisz jako implementacji okno dialogowe środowiska.

Zobacz też

Przestrzeń nazw Microsoft.VisualStudio.Shell.Interop

Powrót do początku

Udostępnij za pośrednictwem