This documentation is archived and is not being maintained.

CodeGotoStatement Class

Represents a goto statement.

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

<SerializableAttribute> _
<ComVisibleAttribute(True)> _
<ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)> _
Public Class CodeGotoStatement _
	Inherits CodeStatement
Dim instance As CodeGotoStatement

CodeGotoStatement can be used to represent a goto statement, which is used in some languages to redirect program flow to a specified label.

The Label property indicates the name of the label at which to continue program execution.


Not all languages support goto statements. Call the Supports method with the GotoStatements flag to determine whether a code generator supports goto statements.

The following example code demonstrates use of a CodeGotoStatement and a CodeLabeledStatement to redirect program flow.

' Declares a type to contain the example code. 
Dim type1 As New CodeTypeDeclaration("Type1")
' Declares an entry point method. 
Dim entry1 As New CodeEntryPointMethod()
' Adds a goto statement to continue program flow at the "JumpToLabel" label. 
Dim goto1 As New CodeGotoStatement("JumpToLabel")
' Invokes Console.WriteLine to print "Test Output", which is skipped by the goto statement. 
Dim method1 As New CodeMethodInvokeExpression(New CodeTypeReferenceExpression("System.Console"), "WriteLine", New CodePrimitiveExpression("Test Output."))
' Declares a label named "JumpToLabel" associated with a method to output a test string using Console.WriteLine. 
Dim method2 As New CodeMethodInvokeExpression(New CodeTypeReferenceExpression("System.Console"), "WriteLine", New CodePrimitiveExpression("Output from labeled statement."))
Dim label1 As New CodeLabeledStatement("JumpToLabel", New CodeExpressionStatement(method2))

' A Visual Basic code generator produces the following source code for the preceeding example code: 

'   Public Class Type1 

'       Public Shared Sub Main() 
'           GoTo JumpToLabel 
'           System.Console.WriteLine("Test Output") 
'           JumpToLabel: 
'           System.Console.WriteLine("Output from labeled statement.") 
'       End Sub 
'   End Class

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0