-Platform (Visual Basic)-platform (Visual Basic)

Gibt an, welche Plattformversion der common Language Runtime (CLR) die Ausgabedatei ausführen kann.Specifies which platform version of common language runtime (CLR) can run the output file.

SyntaxSyntax

-platform:{ x86 | x64 | Itanium | arm | anycpu | anycpu32bitpreferred }  

ArgumenteArguments

BegriffTerm DefinitionDefinition
x86 Kompiliert die Assembly für die 32-Bit-x86-kompatible CLR (Common Language Runtime).Compiles your assembly to be run by the 32-bit, x86-compatible CLR.
x64 Kompiliert Ihre Assembly für die 64-Bit-CLR auf einem Computer, der den AMD64- oder EM64T-Anweisungssatz unterstützt.Compiles your assembly to be run by the 64-bit CLR on a computer that supports the AMD64 or EM64T instruction set.
Itanium Kompiliert Ihre Assembly für die Ausführung durch den 64-Bit-CLR auf einem Computer mit einem Itanium-Prozessor.Compiles your assembly to be run by the 64-bit CLR on a computer with an Itanium processor.
arm Kompiliert Ihre Assembly für die Ausführung auf einem Computer mit einem ARM-Prozessor (Advanced RISC-Computer).Compiles your assembly to be run on a computer with an ARM (Advanced RISC Machine) processor.
anycpu Kompiliert die Assembly für die Ausführung auf einer beliebigen Plattform.Compiles your assembly to run on any platform. Die Anwendung wird auf 32-Bit-Versionen von Windows als 32-Bit-Anwendung und auf 64-Bit-Versionen von Windows als 64-Bit-Anwendung ausgeführt.The application will run as a 32-bit application on 32-bit versions of Windows and as a 64-bit application on 64-bit versions of Windows. Diese Meldung ist der Standardwert.This flag is the default value.
anycpu32bitpreferred Kompiliert die Assembly für die Ausführung auf einer beliebigen Plattform.Compiles your assembly to run on any platform. Die Anwendung wird als 32-Bit-Anwendung auf 32-Bit- und 64-Bit-Versionen von Windows ausgeführt.The application will run as a 32-bit application on both 32-bit and 64-bit versions of Windows. Dieses Flag ist nur gültig für ausführbare Dateien (.(EXE) und erfordert .NET Framework 4.5.NET Framework 4.5.This flag is valid only for executables (.EXE) and requires .NET Framework 4.5.NET Framework 4.5.

HinweiseRemarks

Verwenden Sie die -platform-Option, um den Typ des Zielprozessors für die Ausgabedatei anzugeben.Use the -platform option to specify the type of processor targeted by the output file.

Im Allgemeinen werden in Visual Basic geschriebene .NET Framework-Assemblys identisch ausgeführt, unabhängig von der Plattform.In general, .NET Framework assemblies written in Visual Basic will run the same regardless of the platform. Es gibt jedoch einige Fälle, die sich auf unterschiedlichen Plattformen unterschiedlich verhalten.However, there are some cases that behave differently on different platforms. Diese allgemeinen Fälle sind:These common cases are:

  • Strukturen, die Member enthalten, deren Größe sich je nach Plattform ändert (z. B. jeder beliebige Zeigertyp).Structures that contain members that change size depending on the platform, such as any pointer type.

  • Zeigerarithmetik, die Größen von Konstanten einschließt.Pointer arithmetic that includes constant sizes.

  • Fehlerhafter Plattformaufruf oder COM-Deklarationen, die Integer statt IntPtr für Handles verwenden.Incorrect platform invoke or COM declarations that use Integer for handles instead of IntPtr.

  • Umwandeln von IntPtr zu Integer.Casting IntPtr to Integer.

  • Verwendet einen Plattformaufruf oder COM-Interop für Komponenten, die nicht auf allen Plattformen vorhanden sind.Using platform invoke or COM interop with components that do not exist on all platforms.

Die -Plattform -Option löst einige Probleme, wenn Sie wissen, über die Architektur der Code ausgeführt wird, auf Annahmen getroffen wurde.The -platform option will mitigate some issues if you know you have made assumptions about the architecture your code will run on. Dies gilt insbesondere in folgenden Fällen:Specifically:

  • Wenn Sie sich entscheiden, eine 64-Bit-Plattform anzuzielen und die Anwendung auf einem 32-Bit-Computer ausgeführt wird, wird die Fehlermeldung sehr viel früher angezeigt und ist mehr problemorientiert als eine Fehlermeldung, die auftritt, wenn dieser Switch nicht verwendet wird.If you decide to target a 64-bit platform, and the application is run on a 32-bit machine, the error message comes much earlier and is more targeted at the problem than the error that occurs without using this switch.

  • Wenn Sie die x86-Flag in der Option festlegen und anschließend die Anwendung auf einem 64-Bit-Computer ausgeführt wird, wird die Anwendung im WOW-Subsystem statt nativ ausgeführt.If you set the x86 flag on the option and the application is subsequently run on a 64-bit machine, the application will run in the WOW subsystem instead of running natively.

Auf einem 64-Bit-Windows-Betriebssystem:On a 64-bit Windows operating system:

  • Kompilierte Assemblys mit -platform:x86 werden in der 32-Bit-CLR unter WOW64 ausgeführt.Assemblies compiled with -platform:x86 will execute on the 32-bit CLR running under WOW64.

  • Kompilierte ausführbare Dateien mit dem -platform:anycpu werden in der 64-Bit-CLR ausgeführt.Executables compiled with the -platform:anycpu will execute on the 64-bit CLR.

  • Eine mit der -platform:anycpu kompilierte DLL wird in derselben CLR wie der Prozess, in den sie geladen wurde, ausgeführt.A DLL compiled with the -platform:anycpu will execute on the same CLR as the process into which it loaded.

  • Ausführbare Dateien, die mit -platform:anycpu32bitpreferred kompiliert werden, werden in der 32-Bit-CLR ausgeführt.Executables that are compiled with -platform:anycpu32bitpreferred will execute on the 32-bit CLR.

Weitere Informationen zur Entwicklung einer Anwendung auf einer 64-Bit-Version von Windows ausführen, finden Sie unter 64-Bit-Anwendungen.For more information about how to develop an application to run on a 64-bit version of Windows, see 64-bit Applications.

Festzulegende - Plattform in Visual Studio-IDETo set -platform in the Visual Studio IDE

  1. In Projektmappen-Explorer, wählen Sie das Projekt, öffnen Sie die Projekt , und klicken Sie dann auf Eigenschaften.In Solution Explorer, choose the project, open the Project menu, and then click Properties.

  2. Auf der Kompilieren Registerkarte aktivieren oder Deaktivieren der 32-Bit bevorzugen Kontrollkästchen oder im der Ziel-CPU Liste, wählen Sie einen Wert.On the Compile tab, select or clear the Prefer 32-bit check box, or, in the Target CPU list, choose a value.

    Weitere Informationen finden Sie unter Seite "Kompilieren", Projekt-Designer (Visual Basic).For more information, see Compile Page, Project Designer (Visual Basic).

BeispielExample

Das folgende Beispiel veranschaulicht, wie die -platform-Compileroption genutzt wird.The following example illustrates how to use the -platform compiler option.

vbc -platform:x86 myFile.vb  

Siehe auchSee Also

/ target (Visual Basic)/target (Visual Basic)
Visual Basic-BefehlszeilencompilerVisual Basic Command-Line Compiler
Beispiele für KompilierungsbefehlszeilenSample Compilation Command Lines