ComponentOne Web API Edition
Services / Excel Services / Generate Excel Service / Convert Workbook Formats using Data Posted from Client
In This Topic
Convert Workbook Formats using Data Posted from Client
In This Topic

This section demonstrates how to call the Web API service through a client application and convert between excel file formats, posted from client.

Step 1: Call the Service

Step 2: Run the Client Project

The following example makes a call to the Web API service through HTML as well as WinForms client applications. These clients send a POST request to the service, which returns a response stream. This response stream is then saved in the desired excel file format.

In the following example, user provides excel data file through the client applications. Moreover, the end user needs to specify the service URL, name and appropriate file format of generated excel file through client project. It is so, because the parameters or query string for converting excel formats are sent in the HTTP message body of the POST request and not in the request URL.

Note: Service can convert xls, xlsx, and csv files posted from the client.

Step 1: Call the Service

Complete the following steps to call the Web API service.

  1. Create a WinForms application, as discussed in Configure Client for REST API service. Add four C1Label, three C1TextBox, two C1Button controls and an OpneFileDialog component. Set their text properties so that your form appears as shown below.
  2. Add the following code on button-click event of "Select Data File" button.
    C#
    Copy Code 
    private void button1_Click(object sender, EventArgs e) {
  var result = openFileDialog1.ShowDialog();
  if (result == DialogResult.OK || result == DialogResult.Yes) {
    _filePath = openFileDialog1.FileName;
    if (!string.IsNullOrEmpty(_filePath)) {
      label1.Text = _filePath;
    }
  }
}

  3. Add the following code on button-click event of "Convert Excel Format" button.
    C#
    Copy Code 
    private void button2_Click(object sender, EventArgs e) {
  if (string.IsNullOrEmpty(_filePath)) {
    MessageBox.Show("Invalid response.");
    return;
  }
  using(var client = new HttpClient())
  using(var formData = new MultipartFormDataContent())
  using(var fileStream = File.OpenRead(_filePath)) {
    var fileName = string.IsNullOrEmpty(C1TextBox1.Text) ? "test" : textBox1.Text;
    var fileFormat = string.IsNullOrEmpty(C1TextBox2.Text) ? "xlsx" : textBox2.Text;
    formData.Add(new StringContent(fileName), "FileName");
    formData.Add(new StringContent(fileFormat), "FileFormat");
    formData.Add(new StreamContent(fileStream), "DataFile", Path.GetFileName(_filePath));
    var response = client.PostAsync(C1TextBox3.Text, formData).Result;
    if (!response.IsSuccessStatusCode) {
      MessageBox.Show("Invalid response.");
      return;
    }
    var tempPath = Path.Combine(Path.GetTempPath(), Guid.NewGuid().ToString());
    if (!Directory.Exists(tempPath)) {
      Directory.CreateDirectory(tempPath);
    }
    var tempFilePath = Path.Combine(tempPath, string.Format("{0}.{1}", fileName, fileFormat));
    using(var newFile = File.Create(tempFilePath)) {
      response.Content.ReadAsStreamAsync().Result.CopyTo(newFile);
    }
    Process.Start(tempFilePath);
  }
}

    Note that for POST request, formData is used, which is an instance of System.Net.Http.MultipartFormDataContent class. Through code, we add HTTP content to formData and pass it while sending asynchronous POST request to the specified uri.

Back to Top

Step 2: Run the Client Project

WinForms Application

HTML Application

Explore detailed demo samples of REST API service to convert between excel file formats at:

Back to Top