New-UDUpload

Résumé

Téléverser des fichiers

Syntaxe

New-UDUpload [[-Id] <String>] [[-Accept] <String>] [[-OnUpload] <Endpoint>] [[-Text] <String>] [[-Variant] <String>] [[-Color] <String>] [[-ClassName] <String>] [-HideUploadedFileName] [-ShowLoading] [[-LoadingIndicator] <Object>] [[-LoadingPosition] <String>] [[-Icon] <Object>] [[-IconAlignment] <String>] [<CommonParameters>]

Description

Téléverser des fichiers. Ce composant fonctionne avec UDForm et UDStepper.

Paramètres

-Id

L'ID du téléverseur.

Required?                    false
Position?                    1
Default value                [Guid]::NewGuid()
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-Accept

Le type de fichiers à accepter. Par défaut, ce composant accepte tous les fichiers.

Required?                    false
Position?                    2
Default value                *
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-OnUpload

Un bloc de script à exécuter lorsqu'un fichier est téléversé. Ce paramètre $body contiendra du JSON dans le format suivant :

{ data: 'base64 encoded string of file data', name: 'filename', type: 'type of file, if known' }

$EventData contiendra une classe avec les propriétés suivantes :

public string Name { get; set; } public string FileName { get; set; } public DateTime TimeStamp { get; set; } public string ContentType { get; set; } public string Type => ContentType;

Required?                    false
Position?                    3
Default value
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-Text

Le texte à afficher sur le bouton de téléversement.

Required?                    false
Position?                    4
Default value                Upload
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-Variant

La variante du bouton. La valeur par défaut est contained. Valeurs valides : "text", "outlined", "contained"

Required?                    false
Position?                    5
Default value                contained
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-Color

La couleur du bouton. La valeur par défaut est 'default'. Valeurs valides : "default", "primary", "secondary", "inherit"

Required?                    false
Position?                    6
Default value                primary
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-ClassName

Une classe CSS à appliquer au bouton.

Required?                    false
Position?                    7
Default value
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-HideUploadedFileName

Masque le texte du nom de fichier qui est affiché après le téléversement

Required?                    false
Position?                    named
Default value                False
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-ShowLoading

Affiche un indicateur de chargement pendant l'exécution du gestionnaire d'événement OnClick.

Required?                    false
Position?                    named
Default value                False
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-LoadingIndicator

Un élément personnalisé à afficher au lieu de l'indicateur intégré pour -ShowLoading

Required?                    false
Position?                    8
Default value
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-LoadingPosition

La position de l'indicateur de chargement. Les valeurs valides sont : 'start', 'end', 'center'

Required?                    false
Position?                    9
Default value                center
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-Icon

L'icône à afficher au lieu de l'icône par défaut. Utilisez New-UDIcon pour créer une icône.

Required?                    false
Position?                    10
Default value
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-IconAlignment

Comment aligner l'icône dans le bouton. Les valeurs valides sont : "left", "right"

Required?                    false
Position?                    11
Default value                left
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

Paramètres communs

Cette applet de commande prend en charge les paramètres communs : Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable et OutVariable. Pour plus d'informations, consultez about_CommonParameters.

Sorties

Exemples

Exemple 1 : Téléversement de base

New-UDUpload -Text "Upload" -OnUpload {
    Show-UDToast $Body
} -Id 'upload1'

Un composant de téléversement de base qui affiche une notification lorsqu'un fichier est téléversé.

Exemple 2 : Masquer le nom de fichier

New-UDUpload -Text "Upload" -OnUpload {
    Show-UDToast $Body
} -Id 'upload2' -HideUploadedFileName

Masque le texte du nom de fichier qui est affiché après le téléversement.

Exemple 3 : Icône

New-UDUpload -Text "Upload" -OnUpload {
    Show-UDToast $Body
} -Id 'upload3' -Icon (New-UDIcon -Icon 'Upload')

Composant de téléversement avec une icône au lieu de l'icône par défaut.

Exemple 4 : Alignement de l'icône

New-UDUpload -Text "Upload" -OnUpload {
    Show-UDToast $Body
} -Id 'upload4' -IconAlignment 'right' -Icon (New-UDIcon -Icon 'Upload')

Composant de téléversement avec une icône du côté droit du bouton.

Exemple 5 : Variante

New-UDUpload -Text "Upload" -OnUpload {
    Show-UDToast $Body
} -Id 'upload5' -Variant 'text'

Composant de téléversement avec une variante text.

Exemple 6 : Accept

New-UDUpload -Text "Upload" -OnUpload {
    Show-UDToast $Body
} -Id 'upload6' -Accept ".jpg"

Composant de téléversement qui accepte uniquement les fichiers .jpg.