DownloadsFolder.CreateFileForUserAsync Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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)
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
- 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)
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
- 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)
|