Интегрируйте функцию с переменным количеством аргументов

Этот пример показывает вам, как создать приложение.NET с помощью MATLAB^® функция, которая берет переменное количество аргументов вместо всего один.

В этом примере вы выполняете следующие шаги:

Используйте продукт MATLAB Compiler SDK™, чтобы преобразовать функцию MATLAB drawgraph к методу класса.NET (Plotter) и перенесите класс в блок.NET (VarArgComp). drawgraph функционируйте отображает график входных параметров и называется как метод Plotter класс.
Доступ к компоненту в приложении C# (VarArgApp.cs) или Visual Basic^® приложение (VarArgApp.vb) путем инстанцирования Plotter класс и использование MWArray представлять данные.
Создайте и запустите VarArgDemoApp приложение с помощью Visual Studio^® Среда разработки.NET.

Файлы

Функции MATLAB	`drawgraph.m` `extractcoords.m`
Местоположение функции MATLAB	`matlabroot\toolbox\dotnetbuilder\Examples\VSVersion\NET\VarArgExample\VarArgComp\`
Участок кода C#	`matlabroot\toolbox\dotnetbuilder\Examples\VSVersion\NET\VarArgExample\VarArgCSApp\VarArgApp.cs`
Участок кода Visual Basic	`matlabroot\toolbox\dotnetbuilder\Examples\VSVersion\NET\VarArgExample\VarArgVBApp\VarArgApp.vb`

Процедура

Скопируйте следующую папку, которая поставляется с продуктом MATLAB к вашей папке работы:
```
matlabroot\toolbox\dotnetbuilder\Examples\VSVersion\NET\VarArgExample
```
В командной строке MATLAB перейдите к новому VarArgExample\VarArgComp подпапка в вашей папке работы.

Исследуйте drawgraph и extractcoords функции.

function [xyCoords] = DrawGraph(colorSpec, varargin)

    numVarArgIn= length(varargin);
    xyCoords= zeros(numVarArgIn, 2);

    for idx = 1:numVarArgIn
        xCoord = varargin{idx}(1);
        yCoord = varargin{idx}(2);
        
        x(idx) = xCoord;
        y(idx) = yCoord;
        
        xyCoords(idx,1) = xCoord;
        xyCoords(idx,2) = yCoord;
    end
    
    xmin = min(0, min(x));
    ymin = min(0, min(y));

    axis([xmin fix(max(x))+3 ymin fix(max(y))+3])
    
    plot(x, y, 'color', colorSpec);

function [varargout] = ExtractCoords(coords)

    for idx = 1:nargout
        varargout{idx}= coords(idx,:);
    end

Создайте компонент.NET с приложением Library Compiler или compiler.build.dotNETAssembly использование следующей информации:

Поле Значение
Имя библиотеки VarArgComp
ClassName Plotter
Файлы, чтобы скомпилировать extractcoords.m drawgraph.m

Например, если вы используете compiler.build.dotNETAssemblyВвод:
```
buildResults = compiler.build.dotNETAssembly(["extractcoords.m","drawgraph.m"], ...
'AssemblyName','VarArgComp', ...
'ClassName','Plotter');
```
Для получения дополнительной информации смотрите, что инструкции в Генерируют блок.NET и Создают Приложение.NET.

Поле	Значение
Имя библиотеки	`VarArgComp`
ClassName	`Plotter`
Файлы, чтобы скомпилировать	`extractcoords.m` `drawgraph.m`

Решите, используете ли вы C# или Visual Basic, чтобы получить доступ к компоненту.

Если вы используете C#, запишите исходный код для приложения C#, это получает доступ к компоненту.

Пример приложения для этого примера находится в VarArgExample\VarArgCSApp\VarArgApp.cs.

VarArgApp.cs

using System;

using MathWorks.MATLAB.NET.Utility;
using MathWorks.MATLAB.NET.Arrays;

using VarArgComp;


namespace MathWorks.Examples.VarArgApp
 {
  /// <summary>
  /// This application demonstrates how to call components 
  ///  having methods with varargin/vargout arguments.
  /// </summary>
  class VarArgApp
    {
      #region MAIN

      /// <summary>
      /// The main entry point for the application.
      /// </summary>
      [STAThread]
      static void Main(string[] args)
        {
          // Initialize the input data
          MWNumericArray colorSpec= new double[]
                                        {0.9, 0.0, 0.0};
          MWNumericArray data= 
                  new MWNumericArray(new int[,]{{1,2},{2,4},
                                       {3,6},{4,8},{5,10}});  
          MWArray[] coords= null;

          try
            {
              // Create a new plotter object
              Plotter plotter= new Plotter();

              //Extract a variable number of two element x and y coordinate 
              //  vectors from the data array
              coords= plotter.extractcoords(5, data);

              // Draw a graph using the specified color to connect the 
              //   variable number of input coordinates.
              // Return a two column data array containing the input coordinates.
              data= (MWNumericArray)plotter.drawgraph(colorSpec, 
                coords[0], coords[1], coords[2],coords[3], coords[4]);

              Console.WriteLine("result=\n{0}", data);

              Console.ReadLine();  // Wait for user to exit application

              // Note: You can also pass in the coordinate array directly.
              data= (MWNumericArray)plotter.drawgraph(colorSpec, coords);

              Console.WriteLine("result=\n{0}", data); 
 
              Console.ReadLine();  // Wait for user to exit application
            }

          catch(Exception exception)
            {
              Console.WriteLine("Error: {0}", exception);
            }
        }

      #endregion
    }
  }

Следующие операторы являются альтернативными способами вызвать drawgraph метод:

data= (MWNumericArray)plotter.drawgraph(colorSpec, 
                coords[0], coords[1], coords[2],coords[3], coords[4]);
...
data= (MWNumericArray)plotter.drawgraph((MWArray)colorSpec, coords);

Visual Basic

Если вы используете Visual Basic, запишите исходный код для приложения Visual Basic, это получает доступ к компоненту.

Пример приложения для этого примера находится в VarArgExample\VarArgVBApp\VarArgApp.vb.

VarArgApp.vb

Imports System

Imports MathWorks.MATLAB.NET.Utility
Imports MathWorks.MATLAB.NET.Arrays

Imports VarArgComp


Namespace MathWorks.Demo.VarArgDemoApp


' <summary>
' This application demonstrates how to call components having methods with 
'   varargin/vargout arguments.
' </summary>
Class VarArgDemoApp
    
#Region " MAIN "

        ' <summary>
        ' The main entry point for the application.
        ' </summary>
        Shared Sub Main(ByVal args() As String)

            ' Initialize the input data
            Dim colorSpec As MWNumericArray = 
              New MWNumericArray(New Double() {0.9, 0.0, 0.0})
            Dim data As MWNumericArray = 
              New MWNumericArray(New Integer(,) {{1, 2}, {2, 4}, {3, 6}, {4, 8}, {5, 10}})
            Dim coords() As MWArray = Nothing

            Try

                ' Create a new plotter object
                Dim plotter As Plotter = New Plotter

                'Extract a variable number of two element x and y coordinate 
                ' vectors from the data array
                coords = plotter.extractcoords(5, data)

                ' Draw a graph using the specified color to connect the variable number of 
                '  input coordinates.
                ' Return a two column data array containing the input coordinates.
                data = CType(plotter.drawgraph(colorSpec, coords(0), coords(1), coords(2), 
                   coords(3), coords(4)), _
                             MWNumericArray)

                Console.WriteLine("result={0}{1}", Chr(10), data)

                Console.ReadLine()  ' Wait for user to exit application

                ' Note: You can also pass in the coordinate array directly.
                data = CType(plotter.drawgraph(colorSpec, coords), MWNumericArray)

                Console.WriteLine("result=\{0}{1}", Chr(10), data)

                Console.ReadLine()  ' Wait for user to exit application


            Catch exception As Exception
                Console.WriteLine("Error: {0}", exception)
            End Try
        End Sub
#End Region

    End Class
End Namespace

Следующие операторы являются альтернативными способами вызвать drawgraph метод:

data = CType(plotter.drawgraph(colorSpec, coords(0), coords(1), coords(2), 
       coords(3), coords(4)), MWNumericArray)
...
data = CType(plotter.drawgraph(colorSpec, coords), MWNumericArray)

В любом случае, VarArgApp программа делает следующее:

Инициализирует три массива (colorSpecданные, и coords) использование MWArray библиотека классов
Создает Plotter объект
Вызывает extracoords и drawgraph методы
Использование MWNumericArray представлять данные, необходимые методам
Использует try-catch блокируйтесь, чтобы отловить и обработать любые исключения

Откройте файл проекта.NET, который соответствует вашему языку приложения с помощью Visual Studio.
- C
  Если вы используете C#, VarArgCSApp папка содержит файл проекта Visual Studio.NET для этого примера. Откройте проект в Visual Studio.NET путем двойного клика по VarArgCSApp.csproj в Windows^® Проводник. Можно также открыть его с рабочего стола путем щелчка правой кнопкой по VarArgCSApp.csproj и выбора Open Outside MATLAB.
- Visual Basic
  Если вы используете Visual Basic, VarArgVBApp папка содержит файл проекта Visual Studio.NET для этого примера. Откройте проект в Visual Studio.NET путем двойного клика по VarArgVBApp.vbproj в Windows Explorer. Можно также открыть его с рабочего стола путем щелчка правой кнопкой по VarArgVBApp.vbproj и выбора Open Outside MATLAB.
Создайте ссылку на свой файл блока VarArgComp.dll расположенный в папке, где вы сгенерировали или установили блок.

Создайте ссылку на MWArray API.

Если MATLAB установлен в вашей системе	`matlabroot\toolbox\dotnetbuilder\bin\win64\<framework_version>\MWArray.dll`
Если MATLAB Runtime установлен в вашей системе	`<MATLAB_RUNTIME_INSTALL_DIR>\toolbox\dotnetbuilder\bin\win64\<framework_version>\MWArray.dll`

Создайте и запустите VarArgApp приложение в Visual Studio.NET.
Программа отображает следующий вывод:
```
result=
     1     2
     2     4
     3     6
     4     8
     5    10
```

Документация