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

Пошаговая процедура

1. Если это еще не сделано, скопируйте файлы для этого примера следующим образом:

   1. Скопируйте следующую папку, поставляемую с продуктом MATLAB, в рабочую папку:

      matlabroot\toolbox\dotnetbuilder\Examples\VSVersion\NET\VarArgExample
      

   2. В командной строке MATLAB cd к новому VarArgExample вложенной папки в рабочей папке.

2. Напишите функции MATLAB так же, как и любую функцию MATLAB.

   Код функций в этом примере выглядит следующим образом:

    drawgraph.m

   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);
   
    
   

    extractcoords.m

   function [varargout] = ExtractCoords(coords)
   
       for idx = 1:nargout
           varargout{idx}= coords(idx,:);
       end
   

   Этот код уже находится в вашей рабочей папке в \VarArgExample\VarArgComp\.

3. В галерее приложений MATLAB откройте приложение Компилятор библиотеки.

4. Создайте компонент .NET. Дополнительные сведения см. в разделах Создание сборки .NET и Создание приложения .NET. Используйте следующую информацию:

   Название проекта	VarArgComp
   Имя класса	Plotter
   Файл для компиляции	extractcoords.m   drawgraph.m

5. Запись исходного кода для приложения, получающего доступ к компоненту.

   Пример приложения для этого примера находится в 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
       }
     }
   

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

   • Инициализирует три массива (colorSpec, data, и coords) с использованием MWArray библиотека классов

   • Создает Plotter объект

   • Вызывает extracoords и drawgraph методы

   • Использование MWNumericArray для представления данных, необходимых для методов

   • Использует try-catch блокировать для захвата и обработки любых исключений

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

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

6. Построить VarArgApp с помощью Visual Studio .NET.

   1. VarArgCSApp содержит файл проекта Visual Studio .NET для этого примера. Откройте проект в Visual Studio .NET, дважды щелкнув VarArgCSApp.csproj в Проводнике Windows ®. Его также можно открыть с рабочего стола, щелкнув правой кнопкой мыши на элементе VarArgCSApp.csproj > Открыть вне MATLAB.

   2. Добавление ссылки на MWArray компонент, который является matlabroot\toolbox\dotnetbuilder\bin\architecture\framework_version\mwarray.dll.

   3. Добавьте или, при необходимости, исправьте расположение ссылки на VarArgComp компонент, который был построен на предыдущем шаге. (Компонент, VarArgComp.dll, находится в \VarArgExample\VarArgComp\x86\v4.0\debug\distrib подпапка рабочей области.)

7. Создайте и запустите приложение в Visual Studio .NET.