练习 - 创建第一个方法

已完成

通常,创建方法以执行特定任务。 在本练习中,你将创建一个生成并显示五个随机数的方法。 让我们开始吧!

准备编码环境

本模块包括指导你完成生成和运行演示代码的过程的动手活动。 建议使用 Visual Studio Code 作为开发环境来完成这些活动。 使用 Visual Studio Code 来完成这些活动将帮助你在供全球专业人员使用的开发人员环境中更舒适地编写和运行代码。

  1. 打开 Visual Studio Code。

    可以使用 Windows“开始”菜单(或等效资源 [对于其他 OS])打开 Visual Studio Code。

  2. 在 Visual Studio Code 的“文件”菜单上,选择“打开文件夹”。

  3. 在“打开文件夹”对话框中,导航到 Windows“桌面”文件夹。

    如果你有不同的用于保存代码项目的文件夹位置,则可以改为使用该文件夹位置。 对于此培训,重要的是使用一个容易定位和记住的位置。

  4. 在“打开文件夹”对话框中,选择“选择文件夹”。

    如果看到一个询问是否信任作者的安全对话框,请选择“是”。

  5. 在 Visual Studio Code 的“终端”菜单上,选择“新终端”。

    请注意,“终端”面板中的命令提示符显示当前文件夹的文件夹路径。 例如:

    C:\Users\someuser\Desktop>
    

    注意

    如果你是在自己的电脑上工作,而不是在沙盒或托管环境中工作,并且已完成此 C# 系列中的其他 Microsoft Learn 模块,则可能已经为代码示例创建了一个项目文件夹。 如果是这种情况,可以跳过下一步,该步骤用于在 TestProject 文件夹中创建控制台应用。

  6. 在终端命令提示符处,若要在指定文件夹中新建控制台应用程序,请键入“dotnet new console -o ./CsharpProjects/TestProject”,然后按 Enter。

    此 .NET CLI 命令使用 .NET 程序模板在指定文件夹位置创建新的 C# 控制台应用程序项目。 该命令会创建 CsharpProjects 和 TestProject 文件夹,并使用 TestProject 作为 .csproj 文件的名称。

  7. 在“资源管理器”面板中,展开“CsharpProjects”文件夹。

    你应会看到 TestProject 文件夹和两个文件,一个名为 Program.cs 的 C# 程序文件和一个名为 TestProject.csproj 的 C# 项目文件。

  8. 在“资源管理器”面板中,若要在“编辑器”面板中查看代码文件,请选择“Program.cs”。

  9. 删除现有代码行。

    在本模块中,你将使用此 C# 控制台项目来创建、生成和运行代码示例。

  10. 关闭“终端”面板。

创建显示随机数的方法

若要创建方法,请先创建方法签名,然后添加方法正文。 若要创建方法签名,请声明返回类型、方法名称和参数。 使用包含代码的括号 {} 创建方法正文。

  1. 在 Visual Studio Code 编辑器中输入以下代码:

    void DisplayRandomNumbers();
    

    在这种情况下,方法只需生成并显示信息,因此返回类型为 void。 目前,无需包含任何参数。

  2. 若要创建方法正文,请删除分号 ; 并将代码更新为以下内容:

    void DisplayRandomNumbers() 
    {
        Random random = new Random();
    }
    

    在这里,你将创建一个 Random 对象,用于生成数字。

  3. 若要显示五个随机整数,可将 for 循环添加到方法:

    void DisplayRandomNumbers() 
    {
        Random random = new Random();
    
        for (int i = 0; i < 5; i++) 
        {
            Console.Write($"{random.Next(1, 100)} ");
        }
    }
    

    在此代码中,将生成一个介于 1 和 99(含)之间的数字。 打印数字后,还会添加一个空格。 接下来,你将在方法终止之前显示一个新行。

  4. 使用以下代码更新方法:

    void DisplayRandomNumbers() 
    {
        Random random = new Random();
    
        for (int i = 0; i < 5; i++) 
        {
            Console.Write($"{random.Next(1, 100)} ");
        }
    
        Console.WriteLine();
    }
    

    现在,方法将在显示数字后添加新行。

调用方法

  1. DisplayRandomNumbers 方法上方输入新的空白代码行。

  2. 在新的空白代码行上输入以下代码:

    Console.WriteLine("Generating random numbers:");
    DisplayRandomNumbers();
    
    
  3. 将代码与以下内容进行比较,确保其正确:

    Console.WriteLine("Generating random numbers:");
    DisplayRandomNumbers();
    
    void DisplayRandomNumbers() 
    {
        Random random = new Random();
    
        for (int i = 0; i < 5; i++) 
        {
            Console.Write($"{random.Next(1, 100)} ");
        }
    
        Console.WriteLine();
    }
    

    请注意,使用方法如何使代码易于理解。 可以快速阅读方法名称,了解此代码是否显示随机数,而不是花时间尝试破译 for 循环本身。

检查你的工作

在此任务中,从集成终端运行应用程序,并验证代码是否正常工作。 现在就开始吧。

  1. 使用 Ctrl + S 或使用 Visual Studio Code 的“文件”菜单保存工作。

  2. 如有必要,打开 Visual Studio Code 的集成终端面板。

    在“资源管理器”面板中,若要在 TestProject 文件夹位置打开终端,请右键单击“TestProject”,然后选择“在集成终端中打开”。

  3. 在终端命令提示符处,输入“dotnet run”

  4. 若要验证代码是否按预期工作,检查应用程序的输出类似于以下输出(考虑到随机生成的数字):

    17 29 46 36 3 
    

    如果代码显示不同的结果,则需要查看代码以查找错误并进行更新。 再次运行代码以查看是否已解决问题。 继续更新和运行代码,直到代码生成预期结果。

回顾

下面是到目前为止你了解到的有关方法的内容:

  • 通过声明返回类型、名称、输入参数和方法正文来创建方法。
  • 方法名称应清楚地反映方法执行的任务。
  • 通过调用方法名称并添加括号 () 来使用方法。