CloudFile Klasse

Referenz

Paket:: com.microsoft.azure.storage.file

java.lang.Object
- ListFileItem
- - com.microsoft.azure.storage.file.CloudFile

public class CloudFile implements ListFileItem

Stellt eine Microsoft Azure-Datei dar.

Feldzusammenfassung

Modifizierer und Typ	Feld und Beschreibung
CloudFileClient	fileServiceClient Stellt den Dateidienstclient dar.
CloudFileDirectory	parent Stellt den Verzeichnisverweis der Datei dar.
int	streamMinimumReadSizeInBytes Enthält die minimale Lesegröße bei Verwendung von FileInputStream.
int	streamWriteSizeInBytes Enthält die Anzahl der Bytes, die beim Schreiben in eine gepuffert FileOutputStreamwerden sollen.

Zusammenfassung zum Konstruktor

Konstruktor	Beschreibung
CloudFile(final CloudFile otherFile)	Erstellt eine instance der -Klasse durch Kopieren von Werten aus einer anderen Clouddatei.
CloudFile(final StorageUri fileAbsoluteUri)	Erstellt eine instance der -Klasse unter Verwendung des angegebenen absoluten StorageUri.
CloudFile(final StorageUri fileAbsoluteUri, final StorageCredentials credentials)	Erstellt eine instance der -Klasse unter Verwendung des angegebenen absoluten StorageUri und der angegebenen Anmeldeinformationen.
CloudFile(final StorageUri uri, final String fileName, final CloudFileShare share)	Erstellt eine instance der -Klasse unter Verwendung der angegebenen Adresse, Freigabe und des angegebenen Clients.
CloudFile(final URI fileAbsoluteUri)	Erstellt eine instance der -Klasse unter Verwendung des angegebenen absoluten URI.
CloudFile(final URI fileAbsoluteUri, final StorageCredentials credentials)	Erstellt eine instance der -Klasse unter Verwendung des angegebenen absoluten URI und der angegebenen Anmeldeinformationen.

Methodenzusammenfassung

Modifizierer und Typ	Methode und Beschreibung
final void	abortCopy(final String copyId) Bricht einen laufenden Azure-Dateikopiervorgang ab.
final void	abortCopy(final String copyId, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext) Bricht einen laufenden Azure-Dateikopiervorgang ab.
void	assertValidFilePermissionOrKey() Überprüft, ob filePermission und properties.filePermissionKey des Verzeichnisses nicht festgelegt sind.
void	clearRange(final long offset, final long length) Löscht einen Bereich aus einer Datei. Der Aufruf gibt den speicherplatz frei, der vom angegebenen Bereich verwendet wird. Gelöschte Bereiche werden nicht mehr als Teil der Datei nachverfolgt.
void	clearRange(final long offset, final long length, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext) Löscht einen Bereich aus einer Datei unter Verwendung der angegebenen Lease-ID, der angegebenen Anforderungsoptionen und des angegebenen Vorgangskontexts. Der Aufruf gibt den speicherplatz frei, der vom angegebenen Bereich verwendet wird. Gelöschte Bereiche werden nicht mehr als Teil der Datei nachverfolgt.
ResultSegment<Integer>	closeAllHandlesSegmented() Schließen Sie alle SMB-Handles für diese Datei.
ResultSegment<Integer>	closeAllHandlesSegmented(final ResultContinuation continuationToken, FileRequestOptions options, OperationContext opContext) Schließen Sie alle SMB-Handles für diese Datei.
ResultSegment<Integer>	closeHandleSegmented(String handleID) Schließen Sie alle SMB-Handles für diese Datei.
ResultSegment<Integer>	closeHandleSegmented(String handleID, ResultContinuation continuationToken, FileRequestOptions options, OperationContext opContext) Schließen Sie alle SMB-Handles für diese Datei.
void	create(final long size) Erstellt eine Datei. Wenn die Datei bereits vorhanden ist, wird sie ersetzt.
void	create(final long size, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext) Erstellt eine Datei mit der angegebenen Zugriffsbedingung, den angegebenen Anforderungsoptionen und dem angegebenen Vorgangskontext. Wenn die Datei bereits vorhanden ist, wird sie ersetzt.
final void	delete() Löscht die Datei.
final void	delete(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext) Löscht die Datei unter Verwendung der angegebenen Zugriffsbedingung, der angegebenen Anforderungsoptionen und des angegebenen Vorgangskontexts.
final boolean	deleteIfExists() Löscht die Datei, sofern vorhanden.
final boolean	deleteIfExists(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext) Löscht die Datei, sofern vorhanden, unter Verwendung der angegebenen Zugriffsbedingung, der angegebenen Anforderungsoptionen und des angegebenen Vorgangskontexts.
final void	download(final OutputStream outStream) Lädt den Inhalt einer Datei in einen Stream herunter.
final void	download(final OutputStream outStream, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext) Lädt den Inhalt einer Datei mithilfe der angegebenen Anforderungsoptionen und des angegebenen Vorgangskontexts in einen Stream herunter.
final void	downloadAttributes() Füllt die Eigenschaften und Metadaten einer Datei auf. Diese Methode füllt die Systemeigenschaften und benutzerdefinierten Metadaten der Datei auf. Rufen Sie vor dem Lesen oder Ändern der Eigenschaften oder Metadaten einer Datei diese Methode oder deren Überladung auf, um die neuesten Werte für die Eigenschaften und Metadaten der Datei aus dem Microsoft Azure-Speicherdienst abzurufen.
final void	downloadAttributes(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext) Füllt die Eigenschaften und Metadaten einer Datei mit den angegebenen Anforderungsoptionen und dem angegebenen Vorgangskontext auf. Diese Methode füllt die Systemeigenschaften und benutzerdefinierten Metadaten der Datei auf. Rufen Sie vor dem Lesen oder Ändern der Eigenschaften oder Metadaten einer Datei diese Methode oder deren Überladung auf, um die neuesten Werte für die Eigenschaften und Metadaten der Datei aus dem Microsoft Azure-Speicherdienst abzurufen.
ArrayList<FileRange>	downloadFileRanges() Gibt eine Auflistung von Dateibereichen und deren Anfangs- und Endbyteoffsets zurück. Die Anfangs- und Endbyteoffsets für jeden Dateibereich sind inklusive.
ArrayList<FileRange>	downloadFileRanges(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext) Gibt eine Auflistung von Dateibereichen und deren Anfangs- und Endbyteoffsets unter Verwendung der angegebenen Anforderungsoptionen und des angegebenen Vorgangskontexts zurück.
final void	downloadRange(final long offset, final Long length, final OutputStream outStream) Lädt den Inhalt einer Datei in einen Stream herunter.
final void	downloadRange(final long offset, final Long length, final OutputStream outStream, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext) Lädt den Inhalt einer Datei mithilfe der angegebenen Anforderungsoptionen und des angegebenen Vorgangskontexts in einen Stream herunter.
final int	downloadRangeInternal(final long fileOffset, final Long length, final byte[] buffer, final int bufferOffset, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext) Lädt einen Bytebereich aus der Datei in den angegebenen Bytepuffer herunter.
final int	downloadRangeToByteArray(final long offset, final Long length, final byte[] buffer, final int bufferOffset) Lädt einen Bytebereich aus der Datei in den angegebenen Bytepuffer herunter.
final int	downloadRangeToByteArray(final long offset, final Long length, final byte[] buffer, final int bufferOffset, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext) Lädt einen Bytebereich aus der Datei unter Verwendung der angegebenen Anforderungsoptionen und des Angegebenen Vorgangskontexts in den angegebenen Bytepuffer herunter.
String	downloadText() Lädt eine Datei mithilfe der Standardcodierung der Plattform in eine Zeichenfolge herunter.
String	downloadText(final String charsetName, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext) Lädt eine Datei mithilfe der angegebenen Codierung in eine Zeichenfolge herunter.
final int	downloadToByteArray(final byte[] buffer, final int bufferOffset) Lädt einen Bytebereich aus der Datei in den angegebenen Bytepuffer herunter.
final int	downloadToByteArray(final byte[] buffer, final int bufferOffset, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext) Lädt einen Bytebereich aus der Datei unter Verwendung der angegebenen Anforderungsoptionen und des Angegebenen Vorgangskontexts in den angegebenen Bytepuffer herunter.
void	downloadToFile(final String path) Lädt eine Datei herunter.
void	downloadToFile(final String path, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext) Lädt eine Datei herunter.
final boolean	exists() Überprüft, ob die Datei vorhanden ist.
final boolean	exists(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext) Überprüft, ob die Datei vorhanden ist, wobei die angegebene Zugriffsbedingung, die angegebenen Anforderungsoptionen und der angegebene Vorgangskontext verwendet werden.
String	generateSharedAccessSignature(final SharedAccessFilePolicy policy, final SharedAccessFileHeaders headers, final String groupPolicyIdentifier) Gibt eine Shared Access Signature für die Datei zurück, die den angegebenen Gruppenrichtlinienbezeichner und shared access file headers verwendet. Beachten Sie, dass dies nicht das führende "?" enthält.
String	generateSharedAccessSignature(final SharedAccessFilePolicy policy, final SharedAccessFileHeaders headers, final String groupPolicyIdentifier, final IPRange ipRange, final SharedAccessProtocols protocols) Gibt eine Shared Access Signature für die Datei zurück, die den angegebenen Gruppenrichtlinienbezeichner und shared access file headers verwendet. Beachten Sie, dass dies nicht das führende "?" enthält.
String	generateSharedAccessSignature(final SharedAccessFilePolicy policy, final String groupPolicyIdentifier) Gibt eine Shared Access Signature für die Datei zurück, die den angegebenen Gruppenrichtlinienbezeichner und shared access file headers verwendet. Beachten Sie, dass dies nicht das führende "?" enthält.
CopyState	getCopyState() Gibt den Kopierstatus der Azure-Datei zurück.
final HashMap<String, String>	getMetadata() Gibt die Metadaten für die Datei zurück.
final String	getName() Gibt den Namen der Datei zurück.
final CloudFileDirectory	getParent() Gibt das übergeordnete Element des Dateielements zurück.
String	getParentNameFromURI(final StorageUri resourceAddress, final CloudFileShare share) Ruft den übergeordneten Namen für einen Datei-URI ab.
final FileProperties	getProperties() Gibt die Eigenschaften der Datei zurück.
final CloudFileClient	getServiceClient() Gibt den Dateidienstclient zurück, der der Datei zugeordnet ist.
final CloudFileShare	getShare() Gibt die Dateifreigabe zurück.
final StorageUri	getStorageUri() Gibt die Liste der URIs für alle Speicherorte zurück.
final int	getStreamMinimumReadSizeInBytes() Gibt die minimale Lesegröße zurück, wenn ein verwendet wird FileInputStream.
final int	getStreamWriteSizeInBytes() Ruft die Anzahl der Bytes ab, die beim Schreiben in eine gepuffert FileOutputStreamwerden sollen.
final StorageUri	getTransformedAddress(final OperationContext opContext) Gibt den transformierten URI für die Ressource zurück, wenn die angegebenen Anmeldeinformationen eine Transformation erfordern.
final URI	getUri() Gibt den URI für diese Datei zurück.
Iterable<FileHandle>	listHandles() Ruft die für diese Datei geöffneten SMB-Handles ab.
Iterable<FileHandle>	listHandles(FileRequestOptions options, OperationContext opContext) Ruft die für diese Datei geöffneten SMB-Handles ab.
ResultSegment<FileHandle>	listHandlesSegmented() Ruft die für diese Datei geöffneten SMB-Handles ab.
ResultSegment<FileHandle>	listHandlesSegmented(final Integer maxResults, final ResultContinuation continuationToken, FileRequestOptions options, OperationContext opContext) Ruft die für diese Datei geöffneten SMB-Handles ab.
final FileInputStream	openRead() Öffnet einen Dateieingabestream, um die Datei herunterzuladen. Verwenden Sie setStreamMinimumReadSizeInBytes(final int minimumReadSize) , um die Lesegröße zu konfigurieren.
final FileInputStream	openRead(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext) Öffnet einen Dateieingabedatenstrom, um die Datei mithilfe der angegebenen Anforderungsoptionen und des angegebenen Vorgangskontexts herunterzuladen. Verwenden Sie setStreamMinimumReadSizeInBytes(final int minimumReadSize) , um die Lesegröße zu konfigurieren.
FileOutputStream	openWriteExisting() Öffnet ein Ausgabestreamobjekt, um Daten in die Datei zu schreiben. Die Datei muss bereits vorhanden sein, und alle vorhandenen Daten können überschrieben werden.
FileOutputStream	openWriteExisting(AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext) Öffnet ein Ausgabestreamobjekt, um Daten mithilfe der angegebenen Anforderungsoptionen und des Vorgangskontexts in die Datei zu schreiben. Die Datei muss bereits vorhanden sein, und alle vorhandenen Daten können überschrieben werden.
FileOutputStream	openWriteNew(final long length) Öffnet ein Ausgabestreamobjekt, um Daten in die Datei zu schreiben. Die Datei ist noch nicht vorhanden und wird mit der angegebenen Länge erstellt. Wenn die Datei bereits im Dienst vorhanden ist, wird sie überschrieben. Um ein Überschreiben zu vermeiden und stattdessen einen Fehler auszulösen, verwenden Sie die openWriteNew(final long length, AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext) Überladung mit der entsprechenden AccessCondition.
FileOutputStream	openWriteNew(final long length, AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext) Öffnet ein Ausgabestreamobjekt, um Daten unter Verwendung der angegebenen Lease-ID, der angegebenen Anforderungsoptionen und des Vorgangskontexts in die Datei zu schreiben. Die Datei muss noch nicht vorhanden sein und wird mit der angegebenen Länge erstellt. Wenn die Datei bereits im Dienst vorhanden ist, wird sie überschrieben. Um ein Überschreiben zu vermeiden und stattdessen einen Fehler auszulösen, übergeben Sie eine AccessCondition mit generateIfNotExistsCondition()generierte .
void	putRangeFromURL(final long destOffset, final long length, final URI sourceUri, final long sourceOffset) Lädt einen Bereich von einer Datei in eine andere Datei hoch.
void	putRangeFromURL(final long destOffset, final long length, final URI sourceUri, final long sourceOffset, FileRequestOptions options, OperationContext opContext) Lädt einen Bereich von einer Datei in eine andere Datei mit der angegebenen Lease-ID, den angegebenen Anforderungsoptionen und dem angegebenen Vorgangskontext hoch.
void	resize(long size) Ändert die Größe der Datei auf die angegebene Größe.
void	resize(long size, AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext) Ändert die Größe der Datei auf die angegebene Größe.
void	setFilePermission(String filePermission) Legt die festzulegende Dateiberechtigung der Datei fest.
final void	setMetadata(final HashMap<String, String> metadata) Legt die Metadaten für die Datei fest.
final void	setProperties(final FileProperties properties) Legt die Eigenschaften für die Datei fest.
final void	setShare(final CloudFileShare share) Legt die Freigabe für die Datei fest.
void	setStorageUri(final StorageUri storageUri) Legt die Liste der URIs für alle Speicherorte fest.
void	setStreamMinimumReadSizeInBytes(final int minimumReadSize) Legt die minimale Lesegröße fest, wenn ein verwendet wird FileInputStream.
void	setStreamWriteSizeInBytes(final int streamWriteSizeInBytes) Legt die Anzahl der Bytes fest, die beim Schreiben in eine gepuffert FileOutputStreamwerden sollen.
final String	startCopy(final CloudBlob sourceBlob) Fordert den Dienst auf, mit dem Kopieren der Inhalte, Eigenschaften und Metadaten eines Blobs in eine neue Datei zu beginnen.
final String	startCopy(final CloudBlob sourceBlob, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, FileRequestOptions options, OperationContext opContext) Fordert den Dienst auf, mit dem Kopieren der Inhalte, Eigenschaften und Metadaten einer Datei unter Verwendung der angegebenen Zugriffsbedingungen, der Lease-ID, der Anforderungsoptionen und des Vorgangskontexts in eine neue Datei zu beginnen.
final String	startCopy(final CloudFile sourceFile) Fordert den Dienst auf, mit dem Kopieren der Inhalte, Eigenschaften und Metadaten einer Azure-Datei in eine neue Azure-Datei zu beginnen.
final String	startCopy(final CloudFile sourceFile, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, FileRequestOptions options, OperationContext opContext) Fordert den Dienst auf, mit dem Kopieren der Inhalte, Eigenschaften und Metadaten einer Azure-Datei unter Verwendung der angegebenen Zugriffsbedingungen, der Lease-ID, der Anforderungsoptionen und des Vorgangskontexts in eine neue Azure-Datei zu beginnen.
final String	startCopy(final URI source) Fordert den Dienst auf, mit dem Kopieren der Inhalte, Eigenschaften und Metadaten eines URI in eine neue Azure-Datei zu beginnen.
final String	startCopy(final URI source, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, FileRequestOptions options, OperationContext opContext) Fordert den Dienst auf, mit dem Kopieren der Inhalte, Eigenschaften und Metadaten eines URI in eine neue Azure-Datei unter Verwendung der angegebenen Zugriffsbedingungen, der Lease-ID, der Anforderungsoptionen und des Vorgangskontexts zu beginnen.
void	updateEtagAndLastModifiedFromResponse(HttpURLConnection request)
void	updateLengthFromResponse(HttpURLConnection request)
void	upload(final InputStream sourceStream, final long length) Lädt die Quellstreamdaten in die Datei hoch. Wenn die Datei bereits im Dienst vorhanden ist, wird sie überschrieben.
void	upload(final InputStream sourceStream, final long length, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext) Lädt die Quellstreamdaten mithilfe der angegebenen Zugriffsbedingung, der Anforderungsoptionen und des Vorgangskontexts in die Datei hoch. Wenn die Datei bereits im Dienst vorhanden ist, wird sie überschrieben.
void	uploadFromByteArray(final byte[] buffer, final int offset, final int length) Lädt eine Datei aus Daten in ein Bytearray hoch. Wenn die Datei bereits im Dienst vorhanden ist, wird sie überschrieben.
void	uploadFromByteArray(final byte[] buffer, final int offset, final int length, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext) Lädt eine Datei aus Daten in ein Bytearray hoch. Wenn die Datei bereits im Dienst vorhanden ist, wird sie überschrieben.
void	uploadFromFile(final String path) Lädt eine lokale Datei hoch. Wenn die Datei bereits im Dienst vorhanden ist, wird sie überschrieben.
void	uploadFromFile(final String path, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext) Lädt eine Datei aus einer lokalen Datei hoch. Wenn die Datei bereits im Dienst vorhanden ist, wird sie überschrieben.
final void	uploadMetadata() Lädt die Metadaten der Datei in den Speicherdienst hoch. Verwenden Sie downloadAttributes() , um die neuesten Werte für die Eigenschaften und Metadaten der Datei aus dem Microsoft Azure-Speicherdienst abzurufen.
final void	uploadMetadata(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext) Lädt die Metadaten der Datei mithilfe der Zugriffsbedingung, der Anforderungsoptionen und des Vorgangskontexts in den Speicherdienst hoch. Verwenden Sie downloadAttributes() , um die neuesten Werte für die Eigenschaften und Metadaten der Datei aus dem Microsoft Azure-Speicherdienst abzurufen.
final void	uploadProperties() Lädt die Eigenschaften der Datei in den Speicherdienst hoch. Verwenden Sie downloadAttributes() , um die neuesten Werte für die Eigenschaften und Metadaten der Datei aus dem Microsoft Azure-Speicherdienst abzurufen.
final void	uploadProperties(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext) Lädt die Eigenschaften der Datei mithilfe der Zugriffsbedingung, der Anforderungsoptionen und des Vorgangskontexts hoch. Verwenden Sie downloadAttributes() , um die neuesten Werte für die Eigenschaften und Metadaten der Datei aus dem Microsoft Azure-Speicherdienst abzurufen.
void	uploadRange(final InputStream sourceStream, final long offset, final long length) Lädt einen Bereich in eine Datei hoch.
void	uploadRange(final InputStream sourceStream, final long offset, final long length, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext) Lädt einen Bereich mit der angegebenen Lease-ID, den angegebenen Anforderungsoptionen und dem angegebenen Vorgangskontext in eine Datei hoch.
void	uploadText(final String content) Lädt eine Datei mithilfe der Standardcodierung der Plattform aus einer Zeichenfolge hoch. Wenn die Datei bereits im Dienst vorhanden ist, wird sie überschrieben.
void	uploadText(final String content, final String charsetName, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext) Lädt eine Datei mithilfe der angegebenen Codierung aus einer Zeichenfolge hoch. Wenn die Datei bereits im Dienst vorhanden ist, wird sie überschrieben.

Felddetails

fileServiceClient

protected CloudFileClient fileServiceClient

Stellt den Dateidienstclient dar.

parent

protected CloudFileDirectory parent

Stellt den Verzeichnisverweis der Datei dar.

streamMinimumReadSizeInBytes

protected int streamMinimumReadSizeInBytes= Constants.DEFAULT_MINIMUM_READ_SIZE_IN_BYTES

Enthält die minimale Lesegröße bei Verwendung von FileInputStream.

streamWriteSizeInBytes

protected int streamWriteSizeInBytes= Constants.DEFAULT_STREAM_WRITE_IN_BYTES

Enthält die Anzahl der Bytes, die beim Schreiben in eine gepuffert FileOutputStreamwerden sollen.

Details zum Konstruktor

CloudFile

public CloudFile(final CloudFile otherFile)

Erstellt eine instance der -Klasse durch Kopieren von Werten aus einer anderen Clouddatei.

Parameters:

otherFile - Ein CloudFile -Objekt, das die zu kopierende Datei darstellt.

CloudFile

public CloudFile(final StorageUri fileAbsoluteUri)

Erstellt eine instance der -Klasse unter Verwendung des angegebenen absoluten StorageUri.

Parameters:

fileAbsoluteUri - Ein StorageUri -Objekt, das den absoluten URI für die Datei darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

URISyntaxException - Wenn der Ressourcen-URI ungültig ist.

CloudFile

public CloudFile(final StorageUri fileAbsoluteUri, final StorageCredentials credentials)

Erstellt eine instance der -Klasse unter Verwendung des angegebenen absoluten StorageUri und der angegebenen Anmeldeinformationen.

Parameters:

fileAbsoluteUri - Ein StorageUri -Objekt, das den absoluten URI für die Datei darstellt.

credentials - Ein StorageCredentials Objekt, das zum Authentifizieren des Zugriffs verwendet wird.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

URISyntaxException

CloudFile

protected CloudFile(final StorageUri uri, final String fileName, final CloudFileShare share)

Erstellt eine instance der -Klasse unter Verwendung der angegebenen Adresse, Freigabe und des angegebenen Clients.

Parameters:

uri - Eine StorageUri , die die Adresse des Dateiverzeichnisses darstellt.

fileName - Ein String , der den Namen der Datei darstellt.

share - Ein CloudFileShare -Objekt, das die zugeordnete Dateifreigabe darstellt.

CloudFile

public CloudFile(final URI fileAbsoluteUri)

Erstellt eine instance der -Klasse unter Verwendung des angegebenen absoluten URI.

Parameters:

fileAbsoluteUri - Ein java.net.URI -Objekt, das den absoluten URI für die Datei darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

URISyntaxException - Wenn der Ressourcen-URI ungültig ist.

CloudFile

public CloudFile(final URI fileAbsoluteUri, final StorageCredentials credentials)

Erstellt eine instance der -Klasse unter Verwendung des angegebenen absoluten URI und der angegebenen Anmeldeinformationen.

Parameters:

fileAbsoluteUri - Ein java.net.URI -Objekt, das den absoluten URI für die Datei darstellt.

credentials - Ein StorageCredentials -Objekt, das zum Authentifizieren des Zugriffs verwendet wird.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

URISyntaxException

Details zur Methode

abortCopy

public final void abortCopy(final String copyId)

Bricht einen laufenden Azure-Dateikopiervorgang ab.

Parameters:

copyId - Ein String -Objekt, das den Kopiervorgang identifiziert.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

URISyntaxException

abortCopy

public final void abortCopy(final String copyId, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)

Bricht einen laufenden Azure-Dateikopiervorgang ab.

Parameters:

copyId - Ein String -Objekt, das den Kopiervorgang identifiziert.

accessCondition - Ein AccessCondition -Objekt, das die Zugriffsbedingungen für die Azure-Datei darstellt.

options - Ein FileRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudFileClient) verwendet.

opContext - Ein OperationContext-Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

URISyntaxException

assertValidFilePermissionOrKey

protected void assertValidFilePermissionOrKey()

Überprüft, ob filePermission und properties.filePermissionKey des Verzeichnisses nicht festgelegt sind.

clearRange

public void clearRange(final long offset, final long length)

Löscht einen Bereich aus einer Datei.

Der Aufruf gibt den speicherplatz frei, der vom angegebenen Bereich verwendet wird. Gelöschte Bereiche werden nicht mehr als Teil der Datei nachverfolgt.

Parameters:

offset - Der Offset in Bytes, ab dem mit dem Löschen begonnen werden soll.

length - Die Länge des zu löschenden Datenbereichs in Bytes.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

URISyntaxException

clearRange

public void clearRange(final long offset, final long length, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)

Löscht einen Bereich aus einer Datei unter Verwendung der angegebenen Lease-ID, der angegebenen Anforderungsoptionen und des angegebenen Vorgangskontexts.

Der Aufruf gibt den speicherplatz frei, der vom angegebenen Bereich verwendet wird. Gelöschte Bereiche werden nicht mehr als Teil der Datei nachverfolgt.

Parameters:

offset - Ein long , der den Offset in Bytes darstellt, ab dem mit dem Löschen begonnen werden soll.

length - Ein long , der die Länge des zu löschenden Datenbereichs in Bytes darstellt.

accessCondition - Ein AccessCondition -Objekt, das die Zugriffsbedingungen für die Datei darstellt.

opContext - Ein OperationContext -Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

URISyntaxException

closeAllHandlesSegmented

public ResultSegment closeAllHandlesSegmented()

Schließen Sie alle SMB-Handles für diese Datei.

Returns:

Ein ResultSegment<T> -Element, das die Anzahl der abgeschlossenen Handles und eine Fortsetzung aufweist, die verfolgt werden soll, falls der Vorgang zu lange dauerte, bis er atomar abgeschlossen wurde.

Throws:

StorageException

closeAllHandlesSegmented

public ResultSegment closeAllHandlesSegmented(final ResultContinuation continuationToken, FileRequestOptions options, OperationContext opContext)

Schließen Sie alle SMB-Handles für diese Datei.

Parameters:

continuationToken - Ein ResultContinuation -Objekt, das ein Fortsetzungstoken darstellt, das von einem vorherigen Auflistungsvorgang zurückgegeben wurde.

opContext - Ein OperationContext -Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Returns:

Throws:

StorageException

closeHandleSegmented

public ResultSegment closeHandleSegmented(String handleID)

Schließen Sie alle SMB-Handles für diese Datei.

Parameters:

handleID - Das zu schließende Handle.

Returns:

Throws:

StorageException

closeHandleSegmented

public ResultSegment closeHandleSegmented(String handleID, ResultContinuation continuationToken, FileRequestOptions options, OperationContext opContext)

Schließen Sie alle SMB-Handles für diese Datei.

Parameters:

handleID - Das zu schließende Handle.

continuationToken - Ein ResultContinuation -Objekt, das ein Fortsetzungstoken darstellt, das von einem vorherigen Auflistungsvorgang zurückgegeben wurde.

opContext - Ein OperationContext -Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Returns:

Throws:

StorageException

create

public void create(final long size)

Erstellt eine Datei. Wenn die Datei bereits vorhanden ist, wird sie ersetzt.

Parameters:

size - Ein long , der die Größe der Datei in Bytes darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

URISyntaxException

create

public void create(final long size, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)

Erstellt eine Datei mit der angegebenen Zugriffsbedingung, den angegebenen Anforderungsoptionen und dem angegebenen Vorgangskontext. Wenn die Datei bereits vorhanden ist, wird sie ersetzt.

Parameters:

size - Ein long , der die Größe der Datei in Bytes darstellt.

accessCondition - Ein AccessCondition -Objekt, das die Zugriffsbedingungen für die Datei darstellt.

opContext - Ein OperationContext -Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

URISyntaxException

delete

public final void delete()

Löscht die Datei.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

URISyntaxException

delete

public final void delete(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)

Löscht die Datei unter Verwendung der angegebenen Zugriffsbedingung, der angegebenen Anforderungsoptionen und des angegebenen Vorgangskontexts.

Parameters:

accessCondition - Ein AccessCondition-Objekt, das die Zugriffsbedingung für die Datei darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

URISyntaxException

deleteIfExists

public final boolean deleteIfExists()

Löscht die Datei, sofern vorhanden.

Returns:

true , wenn die Datei gelöscht wurde; falseandernfalls .

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

URISyntaxException

deleteIfExists

public final boolean deleteIfExists(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)

Löscht die Datei, sofern vorhanden, unter Verwendung der angegebenen Zugriffsbedingung, der angegebenen Anforderungsoptionen und des angegebenen Vorgangskontexts.

Parameters:

accessCondition - Ein AccessCondition-Objekt, das die Zugriffsbedingung für die Datei darstellt.

Returns:

true , wenn die Datei vorhanden und gelöscht wurde; Andernfalls false

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

URISyntaxException

download

public final void download(final OutputStream outStream)

Lädt den Inhalt einer Datei in einen Stream herunter.

Parameters:

outStream - Ein OutputStream -Objekt, das den Zieldatenstrom darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

download

public final void download(final OutputStream outStream, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)

Lädt den Inhalt einer Datei mithilfe der angegebenen Anforderungsoptionen und des angegebenen Vorgangskontexts in einen Stream herunter.

Parameters:

outStream - Ein OutputStream -Objekt, das den Zieldatenstrom darstellt.

accessCondition - Ein AccessCondition-Objekt, das die Zugriffsbedingung für die Datei darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

downloadAttributes

public final void downloadAttributes()

Füllt die Eigenschaften und Metadaten einer Datei auf.

Diese Methode füllt die Systemeigenschaften und benutzerdefinierten Metadaten der Datei auf. Rufen Sie vor dem Lesen oder Ändern der Eigenschaften oder Metadaten einer Datei diese Methode oder deren Überladung auf, um die neuesten Werte für die Eigenschaften und Metadaten der Datei aus dem Microsoft Azure-Speicherdienst abzurufen.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

downloadAttributes

public final void downloadAttributes(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)

Füllt die Eigenschaften und Metadaten einer Datei mit den angegebenen Anforderungsoptionen und dem angegebenen Vorgangskontext auf.

Parameters:

accessCondition - Ein AccessCondition-Objekt, das die Zugriffsbedingung für die Datei darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

downloadFileRanges

public ArrayList downloadFileRanges()

Gibt eine Auflistung von Dateibereichen und deren Anfangs- und Endbyteoffsets zurück.

Die Anfangs- und Endbyteoffsets für jeden Dateibereich sind inklusive.

Returns:

Ein ArrayList -Objekt, das den Satz von Dateibereichen und deren Anfangs- und Endbyteoffsets darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

downloadFileRanges

public ArrayList downloadFileRanges(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)

Gibt eine Auflistung von Dateibereichen und deren Anfangs- und Endbyteoffsets unter Verwendung der angegebenen Anforderungsoptionen und des angegebenen Vorgangskontexts zurück.

Parameters:

accessCondition - Ein AccessCondition -Objekt, das die Zugriffsbedingungen für die Datei darstellt.

opContext - Ein OperationContext -Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Returns:

Ein ArrayList -Objekt, das den Satz von Dateibereichen und deren Anfangs- und Endbyteoffsets darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

downloadRange

public final void downloadRange(final long offset, final Long length, final OutputStream outStream)

Lädt den Inhalt einer Datei in einen Stream herunter.

Parameters:

offset - Ein long , der den Offset darstellt, der als Ausgangspunkt für die Quelle verwendet werden soll.

length - Ein Long , der die Anzahl der zu lesenden Bytes oder nulldarstellt.

outStream - Ein OutputStream -Objekt, das den Zieldatenstrom darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

downloadRange

public final void downloadRange(final long offset, final Long length, final OutputStream outStream, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)

Lädt den Inhalt einer Datei mithilfe der angegebenen Anforderungsoptionen und des angegebenen Vorgangskontexts in einen Stream herunter.

Parameters:

offset - Ein long , der den Offset darstellt, der als Ausgangspunkt für die Quelle verwendet werden soll.

length - Ein Long , der die Anzahl der zu lesenden Bytes oder nulldarstellt.

outStream - Ein OutputStream -Objekt, das den Zieldatenstrom darstellt.

accessCondition - Ein AccessCondition-Objekt, das die Zugriffsbedingung für die Datei darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

downloadRangeInternal

protected final int downloadRangeInternal(final long fileOffset, final Long length, final byte[] buffer, final int bufferOffset, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)

Lädt einen Bytebereich aus der Datei in den angegebenen Bytepuffer herunter.

Parameters:

fileOffset - Ein long , der den Offset innerhalb der Datei darstellt, die mit dem Herunterladen beginnen soll.

length - Ein Long , der die Anzahl der zu lesenden Bytes darstellt.

buffer - Ein byte Array, das den Puffer darstellt, in den geschrieben werden soll.

bufferOffset - Ein int , der den Offset im Bytepuffer darstellt, um mit dem Schreiben zu beginnen.

accessCondition - Ein AccessCondition-Objekt, das die Zugriffsbedingung für die Datei darstellt.

options - Ein FileRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt.

opContext - Ein OperationContext Objekt, das zum Nachverfolgen der Ausführung des Vorgangs verwendet wird.

Throws:

StorageException - eine Ausnahme, die jeden Fehler darstellt, der während des Vorgangs aufgetreten ist.

downloadRangeToByteArray

public final int downloadRangeToByteArray(final long offset, final Long length, final byte[] buffer, final int bufferOffset)

Lädt einen Bytebereich aus der Datei in den angegebenen Bytepuffer herunter.

Parameters:

offset - Ein long , der den Byteoffset darstellt, der als Ausgangspunkt für die Quelle verwendet werden soll.

length - Ein Long , der die Anzahl der zu lesenden Bytes oder NULL darstellt.

buffer - Ein byte Array, das den Puffer darstellt, in den die Dateibytes heruntergeladen werden.

bufferOffset - Ein int , der den Byteoffset darstellt, der als Ausgangspunkt für das Ziel verwendet werden soll.

Throws:

StorageException

downloadRangeToByteArray

public final int downloadRangeToByteArray(final long offset, final Long length, final byte[] buffer, final int bufferOffset, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)

Lädt einen Bytebereich aus der Datei unter Verwendung der angegebenen Anforderungsoptionen und des Angegebenen Vorgangskontexts in den angegebenen Bytepuffer herunter.

Parameters:

offset - Ein long , der den Byteoffset darstellt, der als Ausgangspunkt für die Quelle verwendet werden soll.

length - Ein Long , der die Anzahl der zu lesenden Bytes oder nulldarstellt.

buffer - Ein byte Array, das den Puffer darstellt, in den die Dateibytes heruntergeladen werden.

bufferOffset - Ein int , der den Byteoffset darstellt, der als Ausgangspunkt für das Ziel verwendet werden soll.

accessCondition - Ein AccessCondition-Objekt, das die Zugriffsbedingung für die Datei darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

downloadText

public String downloadText()

Lädt eine Datei mithilfe der Standardcodierung der Plattform in eine Zeichenfolge herunter.

Returns:

Ein String , der den Inhalt der Datei darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

IOException

downloadText

public String downloadText(final String charsetName, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)

Lädt eine Datei mithilfe der angegebenen Codierung in eine Zeichenfolge herunter.

Parameters:

charsetName - Ein String , der den Namen des Zeichensatzes darstellt, das zum Codieren des Inhalts verwendet werden soll. Bei NULL wird die Standardcodierung der Plattform verwendet.

accessCondition - Ein AccessCondition-Objekt, das die Zugriffsbedingung für die Datei darstellt.

Returns:

Ein String , der den Inhalt der Datei darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

IOException

downloadToByteArray

public final int downloadToByteArray(final byte[] buffer, final int bufferOffset)

Lädt einen Bytebereich aus der Datei in den angegebenen Bytepuffer herunter.

Parameters:

buffer - Ein byte Array, das den Puffer darstellt, in den die Dateibytes heruntergeladen werden.

bufferOffset - Ein int , der den Byteoffset darstellt, der als Ausgangspunkt für das Ziel verwendet werden soll.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

downloadToByteArray

public final int downloadToByteArray(final byte[] buffer, final int bufferOffset, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)

Lädt einen Bytebereich aus der Datei unter Verwendung der angegebenen Anforderungsoptionen und des Angegebenen Vorgangskontexts in den angegebenen Bytepuffer herunter.

Parameters:

buffer - Ein byte Array, das den Puffer darstellt, in den die Dateibytes heruntergeladen werden.

bufferOffset - Ein long , der den Byteoffset darstellt, der als Ausgangspunkt für das Ziel verwendet werden soll.

accessCondition - Ein AccessCondition-Objekt, das die Zugriffsbedingung für die Datei darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

downloadToFile

public void downloadToFile(final String path)

Lädt eine Datei herunter.

Parameters:

path - Ein String , der den Pfad zu der zu erstellenden Datei darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

IOException

downloadToFile

public void downloadToFile(final String path, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)

Lädt eine Datei herunter.

Parameters:

path - Ein String , der den Pfad zu der zu erstellenden Datei darstellt.

accessCondition - Ein AccessCondition-Objekt, das die Zugriffsbedingung für die Datei darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

IOException

exists

public final boolean exists()

Überprüft, ob die Datei vorhanden ist.

Returns:

true , wenn die Datei vorhanden ist, andernfalls false.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

exists

public final boolean exists(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)

Überprüft, ob die Datei vorhanden ist, wobei die angegebene Zugriffsbedingung, die angegebenen Anforderungsoptionen und der angegebene Vorgangskontext verwendet werden.

Parameters:

accessCondition - Ein AccessCondition-Objekt, das die Zugriffsbedingung für die Datei darstellt.

Returns:

true , wenn die Datei vorhanden ist, andernfalls false.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

generateSharedAccessSignature

public String generateSharedAccessSignature(final SharedAccessFilePolicy policy, final SharedAccessFileHeaders headers, final String groupPolicyIdentifier)

Gibt eine Shared Access Signature für die Datei zurück, die den angegebenen Gruppenrichtlinienbezeichner und shared access file headers verwendet. Beachten Sie, dass dies nicht das führende "?" enthält.

Parameters:

policy - Ein SharedAccessFilePolicy -Objekt, das die Zugriffsrichtlinie für die Shared Access Signature darstellt.

headers - Ein SharedAccessFileHeaders -Objekt, das die optionalen Headerwerte darstellt, die für eine Datei festgelegt werden sollen, auf die mit dieser Shared Access Signature zugegriffen wird.

groupPolicyIdentifier - Ein String , der die Zugriffsrichtlinie auf Freigabeebene darstellt.

Returns:

Eine String , die die Shared Access Signature darstellt.

Throws:

IllegalArgumentException - Wenn die Anmeldeinformationen ungültig sind.

InvalidKeyException - Wenn die Anmeldeinformationen ungültig sind.

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

generateSharedAccessSignature

public String generateSharedAccessSignature(final SharedAccessFilePolicy policy, final SharedAccessFileHeaders headers, final String groupPolicyIdentifier, final IPRange ipRange, final SharedAccessProtocols protocols)

Parameters:

policy - Ein SharedAccessFilePolicy -Objekt, das die Zugriffsrichtlinie für die Shared Access Signature darstellt.

headers - Ein SharedAccessFileHeaders -Objekt, das die optionalen Headerwerte darstellt, die für eine Datei festgelegt werden sollen, auf die mit dieser Shared Access Signature zugegriffen wird.

groupPolicyIdentifier - Ein String , der die Zugriffsrichtlinie auf Freigabeebene darstellt.

ipRange - Ein IPRange -Objekt, das den Bereich der zulässigen IP-Adressen enthält.

protocols - Ein SharedAccessProtocols , der die zulässigen Internetprotokolle darstellt.

Returns:

Eine String , die die Shared Access Signature darstellt.

Throws:

IllegalArgumentException - Wenn die Anmeldeinformationen ungültig sind.

InvalidKeyException - Wenn die Anmeldeinformationen ungültig sind.

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

generateSharedAccessSignature

public String generateSharedAccessSignature(final SharedAccessFilePolicy policy, final String groupPolicyIdentifier)

Parameters:

policy - Ein SharedAccessFilePolicy -Objekt, das die Zugriffsrichtlinie für die Shared Access Signature darstellt.

groupPolicyIdentifier - Ein String , der die Zugriffsrichtlinie auf Freigabeebene darstellt.

Returns:

Eine String , die die Shared Access Signature darstellt.

Throws:

InvalidKeyException - Wenn die Anmeldeinformationen ungültig sind.

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

getCopyState

public CopyState getCopyState()

Gibt den Kopierstatus der Azure-Datei zurück.

Returns:

Ein CopyState -Objekt, das den Kopierstatus der Datei darstellt.

getMetadata

public final HashMap getMetadata()

Gibt die Metadaten für die Datei zurück.

Returns:

Ein java.util.HashMap -Objekt, das die Metadaten für die Datei darstellt.

getName

public final String getName()

Gibt den Namen der Datei zurück.

Returns:

Ein String , der den Namen der Datei darstellt.

getParent

public final CloudFileDirectory getParent()

Gibt das übergeordnete Element des Dateielements zurück.

Overrides:

CloudFile.getParent()

Returns:

Ein CloudFileDirectory -Objekt, das das übergeordnete Verzeichnis für die Datei darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

URISyntaxException - Wenn der Ressourcen-URI ungültig ist.

getParentNameFromURI

protected static String getParentNameFromURI(final StorageUri resourceAddress, final CloudFileShare share)

Ruft den übergeordneten Namen für einen Datei-URI ab.

Parameters:

resourceAddress - Ein StorageUri -Objekt, das den Ressourcen-URI darstellt.

share - Ein CloudFileShare -Objekt, das die Dateifreigabe darstellt.

Returns:

Ein String , der die übergeordnete Adresse für einen Datei-URI darstellt.

Throws:

URISyntaxException

getProperties

public final FileProperties getProperties()

Gibt die Eigenschaften der Datei zurück.

Returns:

Ein FileProperties -Objekt, das die Eigenschaften der Datei darstellt.

getServiceClient

public final CloudFileClient getServiceClient()

Gibt den Dateidienstclient zurück, der der Datei zugeordnet ist.

Returns:

Ein CloudFileClient -Objekt, das den Client darstellt.

getShare

public final CloudFileShare getShare()

Gibt die Dateifreigabe zurück.

Overrides:

CloudFile.getShare()

Returns:

Ein CloudFileShare -Objekt, das die Freigabe der Datei darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

URISyntaxException - Wenn der Ressourcen-URI ungültig ist.

getStorageUri

public final StorageUri getStorageUri()

Gibt die Liste der URIs für alle Speicherorte zurück.

Overrides:

CloudFile.getStorageUri()

Returns:

Ein StorageUri , der die Liste der URIs für alle Speicherorte darstellt.

getStreamMinimumReadSizeInBytes

public final int getStreamMinimumReadSizeInBytes()

Gibt die minimale Lesegröße zurück, wenn ein verwendet wird FileInputStream.

Returns:

Ein int , der die minimale Lesegröße in Byte darstellt, wenn ein FileInputStream -Objekt verwendet wird.

getStreamWriteSizeInBytes

public final int getStreamWriteSizeInBytes()

Ruft die Anzahl der Bytes ab, die beim Schreiben in eine gepuffert FileOutputStreamwerden sollen.

Returns:

Ein int , der die Anzahl der zu puffernden Bytes darstellt.

getTransformedAddress

protected final StorageUri getTransformedAddress(final OperationContext opContext)

Gibt den transformierten URI für die Ressource zurück, wenn die angegebenen Anmeldeinformationen eine Transformation erfordern.

Parameters:

Returns:

Ein StorageUri -Objekt, das den transformierten URI darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

URISyntaxException - Wenn der Ressourcen-URI ungültig ist.

getUri

public final URI getUri()

Gibt den URI für diese Datei zurück.

Overrides:

CloudFile.getUri()

Returns:

Ein java.net.URI -Objekt, das den URI für die Datei darstellt.

listHandles

public Iterable listHandles()

Ruft die für diese Datei geöffneten SMB-Handles ab.

Returns:

Iterable

</code> of the handles that will lazily request new segments. </p>


			
				listHandles
				
						public Iterable listHandles(FileRequestOptions options, OperationContext opContext)


						Ruft die für diese Datei geöffneten SMB-Handles ab.




						Parameters:
							
								options
									- Ein FileRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudFileClient) verwendet.
							
							
								opContext
									- Ein OperationContext -Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.
							

							Returns:
							Iterable
</code> of the handles that will lazily request new segments. </p>


				

			

			
				listHandlesSegmented
				
						public ResultSegment listHandlesSegmented()


						Ruft die für diese Datei geöffneten SMB-Handles ab.





							Returns:
							Ein ResultSegment<T> -Objekt, das ein Segment der aufzählbaren Auflistung von ListFileItem Objekten enthält, die die Dateien und Verzeichnisse darstellen.

						Throws:
							
									StorageException

							
				
			
			
				listHandlesSegmented
				
						public ResultSegment listHandlesSegmented(final Integer maxResults, final ResultContinuation continuationToken, FileRequestOptions options, OperationContext opContext)


						Ruft die für diese Datei geöffneten SMB-Handles ab.




						Parameters:
							
								maxResults
									- Die maximale Anzahl der abzurufenden Ergebnisse. Wenn null oder größer als 5000, gibt der Server bis zu 5.000 Elemente zurück. Die Anzahl muss mindestens 1 sein.
							
							
								continuationToken
									- Ein ResultContinuation -Objekt, das ein Fortsetzungstoken darstellt, das von einem vorherigen Auflistungsvorgang zurückgegeben wurde.
							
							
								options
									- Ein FileRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudFileClient) verwendet.
							
							
								opContext
									- Ein OperationContext -Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.
							

							Returns:
							Ein ResultSegment<T> -Objekt, das ein Segment der aufzählbaren Auflistung von ListFileItem Objekten enthält, die die Dateien und Verzeichnisse darstellen.

						Throws:
							
									StorageException

							
				
			
			
				openRead
				
						public final FileInputStream openRead()


						Öffnet einen Dateieingabestream, um die Datei herunterzuladen. 
Verwenden Sie setStreamMinimumReadSizeInBytes(final int minimumReadSize) , um die Lesegröße zu konfigurieren.





							Returns:
							Ein InputStream -Objekt, das den Stream darstellt, der zum Lesen aus der Datei verwendet werden soll.

						Throws:
							
									StorageException

									- Wenn ein Speicherdienstfehler aufgetreten ist.
							
				
			
			
				openRead
				
						public final FileInputStream openRead(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)


						Öffnet einen Dateieingabedatenstrom, um die Datei mithilfe der angegebenen Anforderungsoptionen und des angegebenen Vorgangskontexts herunterzuladen. 
Verwenden Sie setStreamMinimumReadSizeInBytes(final int minimumReadSize) , um die Lesegröße zu konfigurieren.




						Parameters:
							
								accessCondition
									- Ein AccessCondition-Objekt, das die Zugriffsbedingung für die Datei darstellt.
							
							
								options
									- Ein FileRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudFileClient) verwendet.
							
							
								opContext
									- Ein OperationContext-Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.
							

							Returns:
							Ein InputStream -Objekt, das den Stream darstellt, der zum Lesen aus der Datei verwendet werden soll.

						Throws:
							
									StorageException

									- Wenn ein Speicherdienstfehler aufgetreten ist.
							
				
			
			
				openWriteExisting
				
						public FileOutputStream openWriteExisting()


						Öffnet ein Ausgabestreamobjekt, um Daten in die Datei zu schreiben. Die Datei muss bereits vorhanden sein, und alle vorhandenen Daten können überschrieben werden.





							Returns:
							Ein FileOutputStream -Objekt, das zum Schreiben von Daten in die Datei verwendet wird.

						Throws:
							
									StorageException

									- Wenn ein Speicherdienstfehler aufgetreten ist.
							
							
									URISyntaxException

							
				
			
			
				openWriteExisting
				
						public FileOutputStream openWriteExisting(AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)


						Öffnet ein Ausgabestreamobjekt, um Daten mithilfe der angegebenen Anforderungsoptionen und des Vorgangskontexts in die Datei zu schreiben. Die Datei muss bereits vorhanden sein, und alle vorhandenen Daten können überschrieben werden.




						Parameters:
							
								accessCondition
									- Ein AccessCondition -Objekt, das die Zugriffsbedingungen für die Datei darstellt.
							
							
								options
									- Ein FileRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudFileClient) verwendet.
							
							
								opContext
									- Ein OperationContext -Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.
							

							Returns:
							Ein FileOutputStream -Objekt, das zum Schreiben von Daten in die Datei verwendet wird.

						Throws:
							
									StorageException

									- Wenn ein Speicherdienstfehler aufgetreten ist.
							
							
									URISyntaxException

							
				
			
			
				openWriteNew
				
						public FileOutputStream openWriteNew(final long length)


						Öffnet ein Ausgabestreamobjekt, um Daten in die Datei zu schreiben. Die Datei ist noch nicht vorhanden und wird mit der angegebenen Länge erstellt. Wenn die Datei bereits im Dienst vorhanden ist, wird sie überschrieben. 
Um ein Überschreiben zu vermeiden und stattdessen einen Fehler auszulösen, verwenden Sie die openWriteNew(final long length, AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext) Überladung mit der entsprechenden AccessCondition.




						Parameters:
							
								length
									- Ein long , der die Länge des zu erstellenden Streams in Bytes darstellt.
							

							Returns:
							Ein FileOutputStream -Objekt, das zum Schreiben von Daten in die Datei verwendet wird.

						Throws:
							
									StorageException

									- Wenn ein Speicherdienstfehler aufgetreten ist.
							
							
									URISyntaxException

							
				
			
			
				openWriteNew
				
						public FileOutputStream openWriteNew(final long length, AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)


						Öffnet ein Ausgabestreamobjekt, um Daten unter Verwendung der angegebenen Lease-ID, der angegebenen Anforderungsoptionen und des Vorgangskontexts in die Datei zu schreiben. Die Datei muss noch nicht vorhanden sein und wird mit der angegebenen Länge erstellt. Wenn die Datei bereits im Dienst vorhanden ist, wird sie überschrieben. 
Um ein Überschreiben zu vermeiden und stattdessen einen Fehler auszulösen, übergeben Sie eine AccessCondition mit generateIfNotExistsCondition()generierte .




						Parameters:
							
								length
									- Ein long , der die Länge des zu erstellenden Streams in Bytes darstellt.
							
							
								accessCondition
									- Ein AccessCondition -Objekt, das die Zugriffsbedingungen für die Datei darstellt.
							
							
								options
									- Ein FileRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudFileClient) verwendet.
							
							
								opContext
									- Ein OperationContext -Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.
							

							Returns:
							Ein FileOutputStream -Objekt, das zum Schreiben von Daten in die Datei verwendet wird.

						Throws:
							
									StorageException

									- Wenn ein Speicherdienstfehler aufgetreten ist.
							
							
									URISyntaxException

							
				
			
			
				putRangeFromURL
				
						public void putRangeFromURL(final long destOffset, final long length, final URI sourceUri, final long sourceOffset)


						Lädt einen Bereich von einer Datei in eine andere Datei hoch.




						Parameters:
							
								destOffset
									- Ein long , der den Offset in Byte darstellt, an dem mit dem Schreiben der Daten begonnen werden soll.
							
							
								length
									- Ein long , der die Länge der zu schreibenden und zu lesenden Daten in Bytes darstellt.
							
							
								sourceUri
									- Ein java.net.URI -Objekt, das den Quell-URI angibt.
							
							
								sourceOffset
									- Ein long , der den Offset in Anzahl von Bytes darstellt, an dem mit dem Lesen der Daten begonnen werden soll.
							


						Throws:
							
									StorageException

									- Wenn ein Speicherdienstfehler aufgetreten ist.
							
							
									URISyntaxException

							
				
			
			
				putRangeFromURL
				
						public void putRangeFromURL(final long destOffset, final long length, final URI sourceUri, final long sourceOffset, FileRequestOptions options, OperationContext opContext)


						Lädt einen Bereich von einer Datei in eine andere Datei mit der angegebenen Lease-ID, den angegebenen Anforderungsoptionen und dem angegebenen Vorgangskontext hoch.




						Parameters:
							
								destOffset
									- Ein long , der den Offset in Byte darstellt, an dem mit dem Schreiben der Daten begonnen werden soll.
							
							
								length
									- Ein long , der die Länge der zu schreibenden und zu lesenden Daten in Bytes darstellt.
							
							
								sourceUri
									- Ein java.net.URI -Objekt, das den Quell-URI angibt.
							
							
								sourceOffset
									- Ein long , der den Offset in Anzahl von Bytes darstellt, an dem mit dem Lesen der Daten begonnen werden soll.
							
							
								options
									- Ein FileRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudFileClient) verwendet.
							
							
								opContext
									- Ein OperationContext -Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.
							


						Throws:
							
									StorageException

									- Wenn ein Speicherdienstfehler aufgetreten ist.
							
							
									URISyntaxException

							
				
			
			
				resize
				
						public void resize(long size)


						Ändert die Größe der Datei auf die angegebene Größe.




						Parameters:
							
								size
									- Ein long , der die Größe der Datei in Bytes darstellt.
							


						Throws:
							
									StorageException

									- Wenn ein Speicherdienstfehler aufgetreten ist.
							
							
									URISyntaxException

							
				
			
			
				resize
				
						public void resize(long size, AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)


						Ändert die Größe der Datei auf die angegebene Größe.




						Parameters:
							
								size
									- Ein long , der die Größe der Datei in Bytes darstellt.
							
							
								accessCondition
									- Ein AccessCondition -Objekt, das die Zugriffsbedingungen für die Datei darstellt.
							
							
								options
									- Ein FileRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudFileClient) verwendet.
							
							
								opContext
									- Ein OperationContext -Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.
							


						Throws:
							
									StorageException

									- Wenn ein Speicherdienstfehler aufgetreten ist.
							
							
									URISyntaxException

							
				
			
			
				setFilePermission
				
						public void setFilePermission(String filePermission)


						Legt die festzulegende Dateiberechtigung der Datei fest.



						Parameters:
							
								filePermission
									- Ein String , der die festzulegende Dateiberechtigung der Datei darstellt.
							


				
			
			
				setMetadata
				
						public final void setMetadata(final HashMap metadata)


						Legt die Metadaten für die Datei fest.




						Parameters:
							
								metadata
									- Ein java.util.HashMap -Objekt, das die Metadaten enthält, die der Datei zugewiesen werden.
							


				
			
			
				setProperties
				
						protected final void setProperties(final FileProperties properties)


						Legt die Eigenschaften für die Datei fest.




						Parameters:
							
								properties
									- Ein FileProperties -Objekt, das die Eigenschaften darstellt, die der Datei zugewiesen werden.
							


				
			
			
				setShare
				
						protected final void setShare(final CloudFileShare share)


						Legt die Freigabe für die Datei fest.




						Parameters:
							
								share
									- Ein CloudFileShare -Objekt, das die Freigabe darstellt, die der Datei zugewiesen wird.
							


				
			
			
				setStorageUri
				
						protected void setStorageUri(final StorageUri storageUri)


						Legt die Liste der URIs für alle Speicherorte fest.




						Parameters:
							
								storageUri
									- Ein StorageUri , der die Liste der URIs für alle Speicherorte darstellt.
							


				
			
			
				setStreamMinimumReadSizeInBytes
				
						public void setStreamMinimumReadSizeInBytes(final int minimumReadSize)


						Legt die minimale Lesegröße fest, wenn ein verwendet wird FileInputStream.




						Parameters:
							
								minimumReadSize
									- Ein int , das die minimale Anzahl von Bytes darstellt, die beim Lesen aus einer Datei während der Verwendung eines FileInputStream -Objekts gepuffert werden sollen. Muss größer oder gleich 16 KB sein.
							


						Throws:
							
									IllegalArgumentException

									- Wenn minimumReadSize kleiner als 16 KB ist.
							
				
			
			
				setStreamWriteSizeInBytes
				
						public void setStreamWriteSizeInBytes(final int streamWriteSizeInBytes)


						Legt die Anzahl der Bytes fest, die beim Schreiben in eine gepuffert FileOutputStreamwerden sollen.




						Parameters:
							
								streamWriteSizeInBytes
									- Ein int , der die Anzahl von Bytes darstellt, die bei Verwendung eines FileOutputStream -Objekts gepuffert werden sollen, und reicht von 512 Bytes bis einschließlich 4 MB.
							


						Throws:
							
									IllegalArgumentException

									- Wenn streamWriteSizeInBytes kleiner als 512 Bytes oder größer als 4 MB ist.
							
				
			
			
				startCopy
				
						public final String startCopy(final CloudBlob sourceBlob)


						Fordert den Dienst auf, mit dem Kopieren der Inhalte, Eigenschaften und Metadaten eines Blobs in eine neue Datei zu beginnen.




						Parameters:
							
								sourceBlob
									- Ein CloudBlob -Objekt, das das zu kopierende Quellblob darstellt.
							

							Returns:
							Ein String , der die kopier-ID darstellt, die dem Kopiervorgang zugeordnet ist.

						Throws:
							
									StorageException

									- Wenn ein Speicherdienstfehler aufgetreten ist.
							
							
									URISyntaxException

							
				
			
			
				startCopy
				
						public final String startCopy(final CloudBlob sourceBlob, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, FileRequestOptions options, OperationContext opContext)


						Fordert den Dienst auf, mit dem Kopieren der Inhalte, Eigenschaften und Metadaten einer Datei unter Verwendung der angegebenen Zugriffsbedingungen, der Lease-ID, der Anforderungsoptionen und des Vorgangskontexts in eine neue Datei zu beginnen.




						Parameters:
							
								sourceBlob
									- Ein CloudBlob -Objekt, das das zu kopierende Quellblob darstellt.
							
							
								sourceAccessCondition
									- Ein AccessCondition -Objekt, das die Zugriffsbedingungen für das Quellblob darstellt.
							
							
								destinationAccessCondition
									- Ein AccessCondition -Objekt, das die Zugriffsbedingungen für die Zieldatei darstellt.
							
							
								options
									- Ein BlobRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients (CloudBlobClient) verwendet.
							
							
								opContext
									- Ein OperationContext-Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.
							

							Returns:
							Ein String , der die kopier-ID darstellt, die dem Kopiervorgang zugeordnet ist.

						Throws:
							
									StorageException

									- Wenn ein Speicherdienstfehler aufgetreten ist.
							
							
									URISyntaxException

							
				
			
			
				startCopy
				
						public final String startCopy(final CloudFile sourceFile)


						Fordert den Dienst auf, mit dem Kopieren der Inhalte, Eigenschaften und Metadaten einer Azure-Datei in eine neue Azure-Datei zu beginnen.




						Parameters:
							
								sourceFile
									- Ein CloudFile -Objekt, das die zu kopierende Azure-Datei darstellt.
							

							Returns:
							Ein String , der die kopier-ID darstellt, die dem Kopiervorgang zugeordnet ist.

						Throws:
							
									StorageException

									- Wenn ein Speicherdienstfehler aufgetreten ist.
							
							
									URISyntaxException

							
				
			
			
				startCopy
				
						public final String startCopy(final CloudFile sourceFile, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, FileRequestOptions options, OperationContext opContext)


						Fordert den Dienst auf, mit dem Kopieren der Inhalte, Eigenschaften und Metadaten einer Azure-Datei unter Verwendung der angegebenen Zugriffsbedingungen, der Lease-ID, der Anforderungsoptionen und des Vorgangskontexts in eine neue Azure-Datei zu beginnen.




						Parameters:
							
								sourceFile
									- Ein CloudFile -Objekt, das die zu kopierende Quelldatei darstellt.
							
							
								sourceAccessCondition
									- Ein AccessCondition -Objekt, das die Zugriffsbedingungen für die Quelle darstellt.
							
							
								destinationAccessCondition
									- Ein AccessCondition -Objekt, das die Zugriffsbedingungen für das Ziel darstellt.
							
							
								options
									- Ein FileRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients (CloudFileClient) verwendet.
							
							
								opContext
									- Ein OperationContext-Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.
							

							Returns:
							Ein String , der die kopier-ID darstellt, die dem Kopiervorgang zugeordnet ist.

						Throws:
							
									StorageException

									- Wenn ein Speicherdienstfehler aufgetreten ist.
							
							
									URISyntaxException

							
				
			
			
				startCopy
				
						public final String startCopy(final URI source)


						Fordert den Dienst auf, mit dem Kopieren der Inhalte, Eigenschaften und Metadaten eines URI in eine neue Azure-Datei zu beginnen.




						Parameters:
							
								source
									- Die Quelle.java.net.URI
							

							Returns:
							Ein String , der die kopier-ID darstellt, die dem Kopiervorgang zugeordnet ist.

						Throws:
							
									StorageException

									- Wenn ein Speicherdienstfehler aufgetreten ist.
							
							
									URISyntaxException

							
				
			
			
				startCopy
				
						public final String startCopy(final URI source, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, FileRequestOptions options, OperationContext opContext)


						Fordert den Dienst auf, mit dem Kopieren der Inhalte, Eigenschaften und Metadaten eines URI in eine neue Azure-Datei unter Verwendung der angegebenen Zugriffsbedingungen, der Lease-ID, der Anforderungsoptionen und des Vorgangskontexts zu beginnen.




						Parameters:
							
								source
									- Die Quelle.java.net.URI
							
							
								sourceAccessCondition
									- Ein AccessCondition -Objekt, das die Zugriffsbedingungen für die Quelle darstellt.
							
							
								destinationAccessCondition
									- Ein AccessCondition -Objekt, das die Zugriffsbedingungen für das Ziel darstellt.
							
							
								options
									- Ein FileRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients (CloudFileClient) verwendet.
							
							
								opContext
									- Ein OperationContext-Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.
							

							Returns:
							Ein String , der die kopier-ID darstellt, die dem Kopiervorgang zugeordnet ist.

						Throws:
							
									StorageException

									- Wenn ein Speicherdienstfehler aufgetreten ist.
							
							
									URISyntaxException

							
				
			
			
				updateEtagAndLastModifiedFromResponse
				
						protected void updateEtagAndLastModifiedFromResponse(HttpURLConnection request)




						Parameters:
							
								request
							


				
			
			
				updateLengthFromResponse
				
						protected void updateLengthFromResponse(HttpURLConnection request)




						Parameters:
							
								request
							


				
			
			
				upload
				
						public void upload(final InputStream sourceStream, final long length)


						Lädt die Quellstreamdaten in die Datei hoch. Wenn die Datei bereits im Dienst vorhanden ist, wird sie überschrieben.




						Parameters:
							
								sourceStream
									- Ein InputStream Objekt, aus dem gelesen werden soll.
							
							
								length
									- Eine long , die die Länge der Datenstromdaten in Bytes darstellt. Muss ungleich 0 sein.
							


						Throws:
							
									IOException

									- Wenn eine E/A-Ausnahme aufgetreten ist.
							
							
									StorageException

									- Wenn ein Speicherdienstfehler aufgetreten ist.
							
							
									URISyntaxException

							
				
			
			
				upload
				
						public void upload(final InputStream sourceStream, final long length, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)


						Lädt die Quellstreamdaten mithilfe der angegebenen Zugriffsbedingung, der Anforderungsoptionen und des Vorgangskontexts in die Datei hoch. Wenn die Datei bereits im Dienst vorhanden ist, wird sie überschrieben.




						Parameters:
							
								sourceStream
									- Ein InputStream Objekt, aus dem gelesen werden soll.
							
							
								length
									- Eine long , die die Länge der Datenstromdaten in Bytes darstellt. Dieser muss größer als oder gleich 0 sein.
							
							
								accessCondition
									- Ein AccessCondition -Objekt, das die Zugriffsbedingungen für die Datei darstellt.
							
							
								options
									- Ein FileRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudFileClient) verwendet.
							
							
								opContext
									- Ein OperationContext -Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.
							


						Throws:
							
									IOException

									- Wenn eine E/A-Ausnahme aufgetreten ist.
							
							
									StorageException

									- Wenn ein Speicherdienstfehler aufgetreten ist.
							
							
									URISyntaxException

							
				
			
			
				uploadFromByteArray
				
						public void uploadFromByteArray(final byte[] buffer, final int offset, final int length)


						Lädt eine Datei aus Daten in ein Bytearray hoch. Wenn die Datei bereits im Dienst vorhanden ist, wird sie überschrieben.




						Parameters:
							
								buffer
									- Ein byte Array, das die Daten darstellt, die in die Datei geschrieben werden sollen.
							
							
								offset
									- Ein int , der den Offset des Bytearrays darstellt, aus dem der Datenupload gestartet werden soll.
							
							
								length
									- Ein int , der die Anzahl der Bytes darstellt, die aus dem Eingabepuffer hochgeladen werden sollen.
							


						Throws:
							
									StorageException

									- Wenn ein Speicherdienstfehler aufgetreten ist.
							
							
									IOException

							
							
									URISyntaxException

							
				
			
			
				uploadFromByteArray
				
						public void uploadFromByteArray(final byte[] buffer, final int offset, final int length, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)


						Lädt eine Datei aus Daten in ein Bytearray hoch. Wenn die Datei bereits im Dienst vorhanden ist, wird sie überschrieben.




						Parameters:
							
								buffer
									- Ein byte Array, das die Daten darstellt, die in die Datei geschrieben werden sollen.
							
							
								offset
									- Ein int , der den Offset des Bytearrays darstellt, aus dem der Datenupload gestartet werden soll.
							
							
								length
									- Ein int , der die Anzahl der Bytes darstellt, die aus dem Eingabepuffer hochgeladen werden sollen.
							
							
								accessCondition
									- Ein AccessCondition-Objekt, das die Zugriffsbedingung für die Datei darstellt.
							
							
								options
									- Ein FileRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudFileClient) verwendet.
							
							
								opContext
									- Ein OperationContext-Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.
							


						Throws:
							
									StorageException

									- Wenn ein Speicherdienstfehler aufgetreten ist.
							
							
									IOException

							
							
									URISyntaxException

							
				
			
			
				uploadFromFile
				
						public void uploadFromFile(final String path)


						Lädt eine lokale Datei hoch. Wenn die Datei bereits im Dienst vorhanden ist, wird sie überschrieben.




						Parameters:
							
								path
									- Ein String , der den Pfad zur datei darstellt, die hochgeladen werden soll.
							


						Throws:
							
									StorageException

									- Wenn ein Speicherdienstfehler aufgetreten ist.
							
							
									IOException

							
							
									URISyntaxException

							
				
			
			
				uploadFromFile
				
						public void uploadFromFile(final String path, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)


						Lädt eine Datei aus einer lokalen Datei hoch. Wenn die Datei bereits im Dienst vorhanden ist, wird sie überschrieben.




						Parameters:
							
								path
									- Ein String , der den Pfad zur datei darstellt, die hochgeladen werden soll.
							
							
								accessCondition
									- Ein AccessCondition-Objekt, das die Zugriffsbedingung für die Datei darstellt.
							
							
								options
									- Ein FileRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudFileClient) verwendet.
							
							
								opContext
									- Ein OperationContext-Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.
							


						Throws:
							
									StorageException

									- Wenn ein Speicherdienstfehler aufgetreten ist.
							
							
									IOException

							
							
									URISyntaxException

							
				
			
			
				uploadMetadata
				
						public final void uploadMetadata()


						Lädt die Metadaten der Datei in den Speicherdienst hoch. 
Verwenden Sie downloadAttributes() , um die neuesten Werte für die Eigenschaften und Metadaten der Datei aus dem Microsoft Azure-Speicherdienst abzurufen.






						Throws:
							
									StorageException

									- Wenn ein Speicherdienstfehler aufgetreten ist.
							
							
									URISyntaxException

							
				
			
			
				uploadMetadata
				
						public final void uploadMetadata(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)


						Lädt die Metadaten der Datei mithilfe der Zugriffsbedingung, der Anforderungsoptionen und des Vorgangskontexts in den Speicherdienst hoch. 
Verwenden Sie downloadAttributes() , um die neuesten Werte für die Eigenschaften und Metadaten der Datei aus dem Microsoft Azure-Speicherdienst abzurufen.




						Parameters:
							
								accessCondition
									- Ein AccessCondition-Objekt, das die Zugriffsbedingung für die Datei darstellt.
							
							
								options
									- Ein FileRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudFileClient) verwendet.
							
							
								opContext
									- Ein OperationContext-Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.
							


						Throws:
							
									StorageException

									- Wenn ein Speicherdienstfehler aufgetreten ist.
							
							
									URISyntaxException

							
				
			
			
				uploadProperties
				
						public final void uploadProperties()


						Lädt die Eigenschaften der Datei in den Speicherdienst hoch. 
Verwenden Sie downloadAttributes() , um die neuesten Werte für die Eigenschaften und Metadaten der Datei aus dem Microsoft Azure-Speicherdienst abzurufen.






						Throws:
							
									StorageException

									- Wenn ein Speicherdienstfehler aufgetreten ist.
							
							
									URISyntaxException

							
				
			
			
				uploadProperties
				
						public final void uploadProperties(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)


						Lädt die Eigenschaften der Datei mithilfe der Zugriffsbedingung, der Anforderungsoptionen und des Vorgangskontexts hoch. 
Verwenden Sie downloadAttributes() , um die neuesten Werte für die Eigenschaften und Metadaten der Datei aus dem Microsoft Azure-Speicherdienst abzurufen.




						Parameters:
							
								accessCondition
									- Ein AccessCondition-Objekt, das die Zugriffsbedingung für die Datei darstellt.
							
							
								options
									- Ein FileRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudFileClient) verwendet.
							
							
								opContext
									- Ein OperationContext-Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.
							


						Throws:
							
									StorageException

									- Wenn ein Speicherdienstfehler aufgetreten ist.
							
							
									URISyntaxException

							
				
			
			
				uploadRange
				
						public void uploadRange(final InputStream sourceStream, final long offset, final long length)


						Lädt einen Bereich in eine Datei hoch.




						Parameters:
							
								sourceStream
									- Ein InputStream -Objekt, das den Eingabedatenstrom darstellt, der in die Datei geschrieben werden soll.
							
							
								offset
									- Ein long , der den Offset in Byte darstellt, an dem mit dem Schreiben der Daten begonnen werden soll.
							
							
								length
									- Ein long , der die Länge der zu schreibenden Daten in Bytes darstellt.
							


						Throws:
							
									IOException

									- Wenn eine E/A-Ausnahme aufgetreten ist.
							
							
									StorageException

									- Wenn ein Speicherdienstfehler aufgetreten ist.
							
							
									URISyntaxException

							
				
			
			
				uploadRange
				
						public void uploadRange(final InputStream sourceStream, final long offset, final long length, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)


						Lädt einen Bereich mit der angegebenen Lease-ID, den angegebenen Anforderungsoptionen und dem angegebenen Vorgangskontext in eine Datei hoch.




						Parameters:
							
								sourceStream
									- Ein InputStream -Objekt, das den Eingabedatenstrom darstellt, der in die Datei geschrieben werden soll.
							
							
								offset
									- Ein long , der den Offset in Byte darstellt, an dem mit dem Schreiben der Daten begonnen werden soll.
							
							
								length
									- Ein long , der die Länge der zu schreibenden Daten in Bytes darstellt.
							
							
								accessCondition
									- Ein AccessCondition -Objekt, das die Zugriffsbedingungen für die Datei darstellt.
							
							
								options
									- Ein FileRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudFileClient) verwendet.
							
							
								opContext
									- Ein OperationContext -Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.
							


						Throws:
							
									IOException

									- Wenn eine E/A-Ausnahme aufgetreten ist.
							
							
									StorageException

									- Wenn ein Speicherdienstfehler aufgetreten ist.
							
							
									URISyntaxException

							
				
			
			
				uploadText
				
						public void uploadText(final String content)


						Lädt eine Datei mithilfe der Standardcodierung der Plattform aus einer Zeichenfolge hoch. Wenn die Datei bereits im Dienst vorhanden ist, wird sie überschrieben.




						Parameters:
							
								content
									- Ein String , der den Inhalt darstellt, der in die Datei hochgeladen wird.
							


						Throws:
							
									StorageException

									- Wenn ein Speicherdienstfehler aufgetreten ist.
							
							
									IOException

							
							
									URISyntaxException

							
				
			
			
				uploadText
				
						public void uploadText(final String content, final String charsetName, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)


						Lädt eine Datei mithilfe der angegebenen Codierung aus einer Zeichenfolge hoch. Wenn die Datei bereits im Dienst vorhanden ist, wird sie überschrieben.




						Parameters:
							
								content
									- Ein String , der den Inhalt darstellt, der in die Datei hochgeladen wird.
							
							
								charsetName
									- Ein String , der den Namen des Zeichensatzes darstellt, das zum Codieren des Inhalts verwendet werden soll. Bei NULL wird die Standardcodierung der Plattform verwendet.
							
							
								accessCondition
									- Ein AccessCondition-Objekt, das die Zugriffsbedingung für die Datei darstellt.
							
							
								options
									- Ein FileRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudFileClient) verwendet.
							
							
								opContext
									- Ein OperationContext-Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.
							


						Throws:
							
									StorageException

									- Wenn ein Speicherdienstfehler aufgetreten ist.
							
							
									IOException

							
							
									URISyntaxException

							
				
			

	Gilt für:

Freigeben über

CloudFile Klasse

Feldzusammenfassung

Zusammenfassung zum Konstruktor

Methodenzusammenfassung

Felddetails

fileServiceClient

parent

streamMinimumReadSizeInBytes

streamWriteSizeInBytes

Details zum Konstruktor

CloudFile

CloudFile

CloudFile

CloudFile

CloudFile

CloudFile

Details zur Methode

abortCopy

abortCopy

assertValidFilePermissionOrKey

clearRange

clearRange

closeAllHandlesSegmented

closeAllHandlesSegmented

closeHandleSegmented

closeHandleSegmented

create

create

delete

delete

deleteIfExists

deleteIfExists

download

download

downloadAttributes

downloadAttributes

downloadFileRanges

downloadFileRanges

downloadRange

downloadRange

downloadRangeInternal

downloadRangeToByteArray

downloadRangeToByteArray

downloadText

downloadText

downloadToByteArray

downloadToByteArray

downloadToFile

downloadToFile

exists

exists

generateSharedAccessSignature

generateSharedAccessSignature

generateSharedAccessSignature

getCopyState

getMetadata

getName

getParent

getParentNameFromURI

getProperties

getServiceClient

getShare

getStorageUri

getStreamMinimumReadSizeInBytes

getStreamWriteSizeInBytes

getTransformedAddress

getUri

listHandles

listHandles

listHandlesSegmented

listHandlesSegmented

openRead

openRead

openWriteExisting

openWriteExisting

openWriteNew

openWriteNew

putRangeFromURL

putRangeFromURL