Compartir a través de


DownloadsFolder.CreateFileForUserAsync Método

Definición

Sobrecargas

CreateFileForUserAsync(User, String)

Crea un nuevo archivo dentro de la carpeta Descargas de un usuario específico.

CreateFileForUserAsync(User, String, CreationCollisionOption)

Crea un nuevo archivo en la carpeta Descargas de un usuario específico y especifica qué hacer si ya existe un archivo con el mismo nombre en la carpeta Descargas.

CreateFileForUserAsync(User, String)

Crea un nuevo archivo dentro de la carpeta Descargas de un usuario específico.

public:
 static IAsyncOperation<StorageFile ^> ^ CreateFileForUserAsync(User ^ user, Platform::String ^ desiredName);
/// [Windows.Foundation.Metadata.Overload("CreateFileForUserAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
 static IAsyncOperation<StorageFile> CreateFileForUserAsync(User const& user, winrt::hstring const& desiredName);
[Windows.Foundation.Metadata.Overload("CreateFileForUserAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<StorageFile> CreateFileForUserAsync(User user, string desiredName);
function createFileForUserAsync(user, desiredName)
Public Shared Function CreateFileForUserAsync (user As User, desiredName As String) As IAsyncOperation(Of StorageFile)

Parámetros

user
User

Usuario para el que se crea el archivo.

desiredName
String

Platform::String

winrt::hstring

Nombre deseado del archivo que se va a crear.

Si ya existe un archivo con el nombre especificado, se usará un nombre similar pero único. Por ejemplo, si desiredName es "MyFileName.jpg" y un archivo por ese nombre ya existe en la carpeta Descargas, el nuevo archivo se creará con un nombre como "MyFileName (1).jpg" en su lugar.

Devoluciones

Cuando se completa este método, devuelve el nuevo archivo como un objeto StorageFile .

Atributos

Requisitos de Windows

Familia de dispositivos
Windows 10 (se introdujo en la versión 10.0.10586.0)
API contract
Windows.Foundation.UniversalApiContract (se introdujo en la versión v2.0)

Consulte también

Se aplica a

CreateFileForUserAsync(User, String, CreationCollisionOption)

Crea un nuevo archivo en la carpeta Descargas de un usuario específico y especifica qué hacer si ya existe un archivo con el mismo nombre en la carpeta Descargas.

public:
 static IAsyncOperation<StorageFile ^> ^ CreateFileForUserAsync(User ^ user, Platform::String ^ desiredName, CreationCollisionOption option);
/// [Windows.Foundation.Metadata.Overload("CreateFileForUserWithCollisionOptionAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
 static IAsyncOperation<StorageFile> CreateFileForUserAsync(User const& user, winrt::hstring const& desiredName, CreationCollisionOption const& option);
[Windows.Foundation.Metadata.Overload("CreateFileForUserWithCollisionOptionAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<StorageFile> CreateFileForUserAsync(User user, string desiredName, CreationCollisionOption option);
function createFileForUserAsync(user, desiredName, option)
Public Shared Function CreateFileForUserAsync (user As User, desiredName As String, option As CreationCollisionOption) As IAsyncOperation(Of StorageFile)

Parámetros

user
User

Usuario para el que se crea el archivo.

desiredName
String

Platform::String

winrt::hstring

Nombre deseado del archivo que se va a crear.

Si hay un archivo existente en la carpeta actual que ya tiene el desiredName especificado, creationCollisionOption especificado determina cómo Responde Windows al conflicto.

option
CreationCollisionOption

Valor de enumeración que determina cómo responde Windows si desiredName es el mismo que el nombre de un archivo existente en la carpeta actual.

Dado que la aplicación solo puede acceder a los archivos de la carpeta Descargas del usuario especificado, no puede especificar OpenIfExists ni ReplaceExisting para este parámetro.

Devoluciones

Cuando se completa este método, devuelve el nuevo archivo como un objeto StorageFile .

Atributos

Requisitos de Windows

Familia de dispositivos
Windows 10 (se introdujo en la versión 10.0.10586.0)
API contract
Windows.Foundation.UniversalApiContract (se introdujo en la versión v2.0)

Consulte también

Se aplica a