ProcessStartInfo.Verb Property


Gets or sets the verb to use when opening the application or document specified by the FileName property.

Namespace:   System.Diagnostics
Assembly:  System (in System.dll)

<TypeConverterAttribute("System.Diagnostics.Design.VerbConverter, System.Design, Version=, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>
Public Property Verb As String

Property Value

Type: System.String

The action to take with the file that the process opens. The default is an empty string (""), which signifies no action.

Each file name extension has its own set of verbs, which can be obtained by using the Verbs property. For example, the "print" verb will print a document specified by using FileName. The default verb can be specified by using an empty string (""). Examples of verbs are "Edit", "Open", "OpenAsReadOnly", "Print", and "Printto". You should use only verbs that appear in the set of verbs returned by the Verbs property.

When you use the Verb property, you must include the file name extension when you set the value of the FileName property. The file name does not need to have an extension if you manually enter a value for the Verb property.

The following code example starts a new process by using the specified verb and file name. This code example is part of a larger example provided for the Verbs property.

    startInfo = New ProcessStartInfo(fileName)

    If File.Exists(fileName) Then
        i = 0
        Dim verb As String
        For Each verb In startInfo.Verbs
            ' Display the possible verbs.
            Console.WriteLine("  {0}. {1}", i.ToString(), verb)
            i += 1
        Next verb
    End If
    ' Return if no file is selected.
End If

Console.WriteLine("Select the index of the verb.")
Dim index As String = Console.ReadLine()
If Convert.ToInt32(index) < i Then
    verbToUse = startInfo.Verbs(Convert.ToInt32(index))
End If

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.WriteLine("Enter the network address of the target printer:")
    arguments = Console.ReadLine()
    startInfo.Arguments = arguments
End If

.NET Framework
Available since 1.1
Return to top