VB Visual Basic 2026 中文教程
第 2 课 · 实作入门

创建第一个 Windows Forms 应用

现在正式开始编程。你将使用 Visual Studio 2026、Visual Basic 和 .NET 10 建立一个简单的“问候程序”,亲手完成项目创建、界面设计、事件代码和程序运行。

适合:完成第 1 课的初学者建议时间:30–45 分钟实作:HelloVB2026

本课学习目标

  • 在 Visual Studio 2026 中创建 Visual Basic Windows Forms 项目。
  • 正确选择 Windows Forms App.NET 10
  • 认识项目建立后出现的 Form1、Toolbox 和 Properties 窗口。
  • 在窗体上放置 Label、TextBox 和 Button 控件。
  • 为按钮编写第一个 Click 事件处理程序。
  • 运行、测试并保存第一个 VB.NET Windows 桌面应用。

2.1 开始之前

本课使用 Visual Studio 2026 创建现代 .NET Windows Forms 应用,而不是旧版 .NET Framework 项目。

开始前,请确认 Visual Studio 已安装 .NET desktop development(.NET 桌面开发) 工作负载,并包含 .NET 10 组件。Microsoft 当前的 Windows Forms 入门教程也以 Visual Studio 2026 和 .NET 10 为环境。

不要选错模板 创建项目时请选择 Windows Forms App,语言选择 Visual Basic。不要选择名称中带有 .NET Framework 的旧模板。本系列教程采用现代 .NET。

2.2 创建新的 Windows Forms 项目

按照下面的步骤创建本课项目:

启动 Visual Studio 2026

在开始窗口点击 Create a new project(创建新项目)

搜索 Windows Forms 模板

在模板搜索框输入 winforms。如果有语言筛选器,请选择 Visual Basic

选择正确模板

选择 Windows Forms App,确认语言是 Visual Basic,然后点击 Next

输入项目名称

在 Project name 输入 HelloVB2026。Location 可以选择你平时保存 Visual Studio 项目的文件夹,然后点击 Next

选择 .NET 10

在 Framework 下拉列表选择 .NET 10.0 (Long Term Support),然后点击 Create

项目名称为什么使用 HelloVB2026? 这是本课的示范名称。项目名称最好不要包含特殊符号,初学阶段也建议避免空格,这样以后引用命名空间和文件时更清楚。

2.3 项目创建后会看到什么?

Visual Studio 创建项目后,通常会自动打开默认窗体 Form1 的设计器。你会看到几个重要区域:

Form Designer(窗体设计器)中央的窗体画面。你可以在这里设计应用程序界面。
Solution Explorer(解决方案资源管理器)显示项目中的 Form1、项目文件及其他资源。
Toolbox(工具箱)提供 Label、TextBox、Button 等 Windows Forms 控件。
Properties(属性窗口)修改当前选中窗体或控件的 Name、Text、Size 等属性。

如果看不到 Toolbox 或 Properties,可以从 Visual Studio 菜单打开:

  • View → Toolbox
  • View → Properties Window

2.4 设计第一个窗体

我们的第一个应用会让用户输入姓名,然后点击按钮显示欢迎文字。最终界面大致如下:

Hello VB 2026
请输入您的姓名:
显示问候
欢迎学习 Visual Basic 2026!

从 Toolbox 把以下控件拖到 Form1:

控件Name 属性Text 属性
Form1Form1Hello VB 2026
LabellblPrompt请输入您的姓名:
TextBoxtxtName留空
ButtonbtnGreet显示问候
LabellblResult留空
Name 和 Text 不一样 Name 是代码用来识别控件的名称;Text 是用户在界面上看到的文字。例如按钮可以叫 btnGreet,但按钮表面显示“显示问候”。第 3 课会更详细讲解控件与属性。

2.5 为按钮建立 Click 事件

界面设计好以后,我们要告诉程序:用户点击“显示问候”按钮时应该做什么。

  1. 在 Form Designer 中双击 显示问候 按钮。
  2. Visual Studio 会打开代码编辑器。
  3. 它会自动建立 btnGreet_Click 事件处理程序。
  4. 在事件处理程序里面输入下面的代码。
Form1.vb
Public Class Form1

    Private Sub btnGreet_Click(sender As Object, e As EventArgs) Handles btnGreet.Click
        Dim userName As String = txtName.Text.Trim()

        If userName = "" Then
            lblResult.Text = "请输入您的姓名。"
        Else
            lblResult.Text = "你好," & userName & "!欢迎学习 Visual Basic 2026。"
        End If
    End Sub

End Class

2.6 先理解这段代码

现在不需要记住所有语法,只要理解程序的基本逻辑:

1
等待用户点击按钮

Handles btnGreet.Click 表示这个过程会响应按钮的 Click 事件。

2
读取文本框内容

txtName.Text 取得用户输入的姓名,Trim() 去除前后多余空格。

3
检查是否为空

If userName = "" Then 判断用户有没有输入姓名。

4
显示结果

程序通过 lblResult.Text 改变标签上的文字。

关于 & 运算符 Visual Basic 使用 & 把多段文字连接起来。例如 "你好," & userName 会把固定文字和用户输入的姓名组合在一起。

2.7 运行第一个程序

现在可以测试程序了。

启动应用

点击 Visual Studio 工具栏上的绿色启动按钮,或按 F5

测试正常输入

在文本框输入姓名,例如“李明”,然后点击“显示问候”。程序应该显示欢迎文字。

测试空白输入

删除姓名后再次点击按钮。程序应该显示“请输入您的姓名。”

结束运行

关闭应用窗口,或点击 Visual Studio 的停止按钮,回到设计环境。

输入:李明输出:你好,李明!欢迎学习 Visual Basic 2026。
输入:空白输出:请输入您的姓名。

2.8 保存项目并认识主要文件

Ctrl + Shift + S 或使用 File 菜单保存项目。对于本课,你最需要认识的是:

项目内容作用
Form1.vb保存 Form1 的 Visual Basic 程序代码,包括我们刚写的按钮 Click 事件。
Form1.Designer.vb由 Windows Forms Designer 管理的界面代码。初学阶段不要手动修改它。
项目文件保存项目使用的 .NET 目标框架、设置和引用等信息。
不要手动编辑 Form1.Designer.vb Windows Forms Designer 会自动维护这个文件。初学者如果直接修改其中的代码,很容易造成设计器无法正常打开。界面修改请优先使用 Form Designer 和 Properties 窗口。

2.9 初学者常见问题

问题 1

找不到 Visual Basic 模板

检查是否安装了 .NET desktop development 工作负载,并在创建项目时把 Language 筛选为 Visual Basic。

问题 2

看不到 Toolbox

选择 View → Toolbox。Toolbox 通常在 Windows Forms Designer 打开时最有用。

问题 3

双击按钮没有预期代码

确认你是在 Form Designer 上双击 Button 控件,而不是在代码编辑器里双击文字。

问题 4

代码出现红色波浪线

先检查控件 Name 是否与代码完全一致,例如必须是 txtNamelblResult

2.10 小练习:把程序变成“课程欢迎器”

完成基本程序后,尝试做一个小修改:

  1. 把窗体标题改成 Visual Basic 2026 学习助手
  2. 把按钮文字改成 开始学习
  3. 把输出文字改成:“你好,姓名!今天开始学习 VB.NET。”

你不需要新增任何控件,只需要修改属性和一行输出代码。这是练习“界面属性”和“程序代码”之间关系的好方法。

本课复习

  1. 创建现代 VB.NET Windows Forms 项目时,应选择哪个模板?
  2. 为什么本教程不选择 Windows Forms App (.NET Framework)?
  3. Button 的 Name 属性和 Text 属性有什么不同?
  4. 双击 Button 通常会建立什么事件?
  5. txtName.Text 的作用是什么?
  6. 按 F5 在 Visual Studio 中通常用来做什么?