ProcessStartInfo.Verb Свойство

Определение

Пространство имен:

System.Diagnostics

Сборки:

netstandard.dll, System.Diagnostics.Process.dll

Исходный код:

ProcessStartInfo.cs

Возвращает или задает команду, используемую при открытии приложения или документа, указанного свойством FileName .

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

Значение свойства

String

Действие для выполнения с файлом, который открывается процесс. Значение по умолчанию — пустая строка (""), которая означает отсутствие действия.

Примеры

В следующем примере кода запускается новый процесс с помощью указанной команды и имени файла. Этот пример кода является частью более крупного примера, предоставленного для Verbs свойства.

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

Комментарии

Каждое расширение имени файла имеет собственный набор команд, которые можно получить с помощью Verbs свойства. Например, команда "print" выводит документ, указанный с помощью FileName. Команда по умолчанию может быть указана с помощью пустой строки (""). Примерами команд являются "Изменить", "Открыть", "OpenAsReadOnly", "Print" и "Printto". Следует использовать только команды, которые отображаются в наборе команд, возвращаемых свойством Verbs .

При использовании Verb свойства необходимо включить расширение имени файла при установке значения FileName свойства. Имя файла не требует расширения, если вы вручную введите значение для Verb свойства.

См. также раздел

• Verbs