ProcessStartInfo.Verb Propriété

Définition

Espace de noms:

System.Diagnostics

Assemblys:

netstandard.dll, System.Diagnostics.Process.dll

Source:

ProcessStartInfo.cs

Obtient ou définit le verbe à utiliser lors de l’ouverture de l’application ou du document spécifié par la FileName propriété.

public:
 property System::String ^ Verb { System::String ^ get(); void set(System::String ^ value); };

public string Verb { get; set; }

member this.Verb : string with get, set

Public Property Verb As String

Valeur de propriété

String

Action à entreprendre avec le fichier que le processus s’ouvre. La valeur par défaut est une chaîne vide («  »), qui signifie qu’aucune action n’est effectuée.

Exemples

L’exemple de code suivant démarre un nouveau processus à l’aide du verbe et du nom de fichier spécifiés. Cet exemple de code fait partie d’un exemple plus grand fourni pour la Verbs propriété.

int i = 0;
var startInfo = new ProcessStartInfo(fileName);

// Display the possible verbs.
foreach (var verb in startInfo.Verbs)
{
    Console.WriteLine($"  {i++}. {verb}");
}

Console.Write("Select the index of the verb: ");
var indexInput = Console.ReadLine();
int index;
if (Int32.TryParse(indexInput, out index))
{
    if (index < 0 || index >= i)
    {
        Console.WriteLine("Invalid index value.");
        return;
    }

    var verbToUse = startInfo.Verbs[index];

    startInfo.Verb = verbToUse;
    if (verbToUse.ToLower().IndexOf("printto") >= 0)
    {
        // printto implies a specific printer. Ask for the network address.
        // The address must be in the form \\server\printer.
        // The printer address is passed as the Arguments property.
        Console.Write("Enter the network address of the target printer: ");
        var arguments = Console.ReadLine();
        startInfo.Arguments = arguments;
    }

    try
    {
        using (var newProcess = new Process())
        {
            newProcess.StartInfo = startInfo;
            newProcess.Start();

            Console.WriteLine($"{newProcess.ProcessName} for file {fileName} " +
                              $"started successfully with verb '{startInfo.Verb}'!");
        }
    }
    catch (Win32Exception e)
    {
        Console.WriteLine("  Win32Exception caught!");
        Console.WriteLine($"  Win32 error = {e.Message}");
    }
    catch (InvalidOperationException)
    {
        // Catch this exception if the process exits quickly,
        // and the properties are not accessible.
        Console.WriteLine($"Unable to start '{fileName}' with verb {verbToUse}");
    }
}

Dim i = 0
Dim startInfo = New ProcessStartInfo(fileName)

Dim verb As String
For Each verb In startInfo.Verbs
    ' Display the possible verbs.
    Console.WriteLine($"  {i}. {verb}")
    i += 1
Next

Console.Write("Select the index of the verb: ")
Dim indexInput = Console.ReadLine()
Dim index As Integer
If Int32.TryParse(indexInput, index) Then
    If index < 0 OrElse index >= i Then
        Console.WriteLine("Invalid index value.")
        Return
    End If

    Dim verbToUse = startInfo.Verbs(Convert.ToInt32(index))

    startInfo.Verb = verbToUse
    If verbToUse.ToLower().IndexOf("printto") >= 0 Then
        ' printto implies a specific printer.  Ask for the network address.
        ' The address must be in the form \\server\printer.
        Console.Write("Enter the network address of the target printer: ")
        Dim arguments = Console.ReadLine()
        startInfo.Arguments = arguments
    End If

Remarques

Chaque extension de nom de fichier a son propre jeu de verbes, qui peut être obtenu à l’aide de la Verbs propriété. Par exemple, le verbe «print » imprime un document spécifié à l’aide FileNamede . Le verbe par défaut peut être spécifié à l’aide d’une chaîne vide («  »). Voici quelques exemples de verbes : « Edit », « Open », « OpenAsReadOnly », « Print » et « Printto ». Vous devez utiliser uniquement des verbes qui apparaissent dans l’ensemble de verbes retournés par la Verbs propriété.

Lorsque vous utilisez la Verb propriété, vous devez inclure l’extension de nom de fichier lorsque vous définissez la valeur de la FileName propriété. Le nom de fichier n’a pas besoin d’avoir une extension si vous entrez manuellement une valeur pour la Verb propriété.

Voir aussi

• Verbs