MSDN Library
Comprimi il sommario
Espandi il sommario
Informazioni
L'argomento richiesto è visualizzato di seguito, ma non è incluso in questa libreria.

StorageFolder.CreateFileAsync(String, CreationCollisionOption) | createFileAsync(String, CreationCollisionOption) Method

Crea un nuovo file nella cartella corrente e specifica le operazioni da eseguire se un file con lo stesso nome esiste già nella cartella corrente.

Sintassi


storageFolder.createFileAsync(desiredName, options).done( /* I tuoi gestori degli errori e delle operazioni riuscite */ );

Parametri

desiredName

Tipo: String [JavaScript] | System.String [.NET] | Platform::String [C++]

Nome desiderato del file da creare.

Se un file esistente nella cartella corrente ha già l'oggetto desiredName specificato, l'CreationCollisionOption specificata determina la modalità di risposta al conflitto da parte di Windows.

options

Tipo: CreationCollisionOption

Il valore enum che determina la modalità di risposta di Windows se desiredName corrisponde al nome di un file esistente nella cartella corrente.

Valore restituito

Tipo: IAsyncOperation<StorageFile>

Quando questo metodo viene completato correttamente, restituisce il nuovo file come StorageFile.

Osservazioni

Se si tenta di creare un file in una cartella virtuale come una libreria o un gruppo di file, questo metodo potrebbe non riuscire.

Esempi

L'Esempio di accesso ai file mostra come utilizzare il metodo createFileAsync(String, CreationCollisionOption) per creare un nuovo file nella raccolta documenti, in questo modo:


Windows.Storage.KnownFolders.documentsLibrary.createFileAsync("sample.txt",
    Windows.Storage.CreationCollisionOption.replaceExisting).then(function (file) {
        sampleFile = file;
    });

Come mostrato nell'esempio, è possibile utilizzare l'oggetto then o l'oggetto done per dichiarare una funzione che acquisisce ed elabora il nuovo file. Dopo il completamento del metodo createFileAsync(String, CreationCollisionOption), il nuovo file viene passato alla funzione di elaborazione come oggetto StorageFile (file nell'esempio).

Nota  Per creare file nella raccolta documenti occorre dichiarare le funzionalità necessarie nel manifesto dell'applicazione. Ulteriori informazioni sulle funzionalità sono disponibili in Accesso alle risorse dell'utente mediante Windows Runtime.

Requisiti

Client minimo supportato

Windows 8

Server minimo supportato

Windows Server 2012

Telefono minimo supportato

Windows Phone 8

Spazio dei nomi

Windows.Storage
Windows::Storage [C++]

Metadati

Windows.winmd

Vedi anche

StorageFolder
CreateFileAsync(String)

 

 

Mostra:
© 2016 Microsoft