تعيين قيمة النطاق على ورقة عمل Excel يشير هذا REST API إلى وضع قيمة في النطاق، وإذا كان ذلك مناسبًا، فسيتم تحويل القيمة إلى نوع بيانات آخر وسيتم إعادة تعيين تنسيق رقم الخلية.
RSET API
Copy
POST http://api.aspose.cloud/v3.0/cells/{ name} /worksheets/{ sheetName} /ranges/value
معلمات الطلب هي:
اسم المعلمة
يكتب
المسار/سلسلة الاستعلام/نص HTTP
وصف
اسم
خيط
طريق
اسم المصنف
اسم الورقة
خيط
طريق
اسم ورقة العمل
قيمة
خيط
استفسار
قيمة الإدخال
يتراوح
جسم
النطاق في ورقة العمل
تم التحويل
منطقي
استفسار
خطأ شنيع
مجموعة النمط
منطقي
استفسار
خطأ شنيع
مجلد
خيط
استفسار
مجلد المصنف.
اسم التخزين
خيط
استفسار
اسم التخزين.
المواصفات OpenAPI يحدد واجهة برمجة يمكن الوصول إليها بشكل عام ويسمح لك بتنفيذ تفاعلات REST مباشرة من متصفح الويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول بسهولة إلى خدمات الويب Aspose.Cells. يوضح المثال التالي كيفية إجراء مكالمات إلى Cloud API باستخدام cURL.
عائلة SDK السحابية
يُعد استخدام حزمة تطوير برمجيات (SDK) أفضل طريقة لتسريع عملية التطوير. فهي تُعنى بالتفاصيل البسيطة وتُتيح لك التركيز على مهام مشروعك. يُرجى الاطلاع علىمستودع GitHub للحصول على قائمة كاملة بـ Aspose.Cells Cloud SDKs.
توضح أمثلة التعليمات البرمجية التالية كيفية إجراء مكالمات إلى خدمات الويب Aspose.Cells باستخدام مجموعات أدوات تطوير البرامج المختلفة:
C#
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
// For complete examples and data files, please go to https://github.com/aspose-cells-cloud/aspose-cells-cloud-dotnet/
namespace Aspose.Cells.Cloud.SDK.Example
{
using Aspose.Cells.Cloud.SDK.Api;
using Aspose.Cells.Cloud.SDK.Request;
using System;
public partial class CellsApiExample
{
public void PostSetCellRangeValueExample()
{
string CellsCloudClientId ="....";//get from https://dashboard.aspose.cloud/#/applications
string CellsCloudClientSecret="...";//get from https://dashboard.aspose.cloud/#/applications
PostSetCellRangeValueRequest request = new PostSetCellRangeValueRequest { name = "Book1.xlsx", sheetName = "Sheet1", cellarea="A1:C1", type="string" , value="Aspose.Cells Cloud", folder = "TestData/In" };
cellsApi.PostSetCellRangeValue(request);
}
}
}
// Obsolet
//CellsApi instance = new CellsApi(clientId, clientSecret, apiVersion, testbaseurl);
//string name = BOOK1;
//string sheetName = SHEET1;
//string cellarea = CELLAREA;
//string value = Value;
//string type = Type;
//string folder = TEMPFOLDER;
//instance.UploadFile(folder + @"\" + name, File.Open( @"C:\TestData\" +name));
//var response = instance.CellsPostSetCellRangeValue(name, sheetName, cellarea, value, type, folder);
//Assert.IsInstanceOf<CellsCloudResponse>(response, "response is CellsCloudResponse");
//Assert.AreEqual(response.Status, "OK");
Java
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
package com.aspose.cloud.cells.api;
import com.aspose.cloud.cells.client.*;
import com.aspose.cloud.cells.model.*;
import com.aspose.cloud.cells.request.*;
import java.io.IOException;
import org.junit.Test;
import java.util.ArrayList;
import java.util.List;
import java.io.File;
import java.util.HashMap;
public class Example {
private CellsApi api;
public Example(){
try {
api = new CellsApi(
System.getenv("CellsCloudClientId"),
System.getenv("CellsCloudClientSecret"),
"v3.0",
System.getenv("CellsCloudApiBaseUrl")
);
} catch (ApiException e) {
e.printStackTrace();
}
}
public void Run(){
try{
String remoteFolder = "TestData/In";
String localName = "Book1.xlsx";
String remoteName = "Book1.xlsx";
UploadFileRequest uploadFileRequest = new UploadFileRequest();
uploadFileRequest.setPath( remoteFolder + "/" + remoteName );
uploadFileRequest.setStorageName( "");
HashMap<String,File> files = new HashMap<String,File>();
files.put( localName , new File(localName ));
uploadFileRequest.setUploadFiles(files);
api.uploadFile(uploadFileRequest);
GetWorksheetCellsRangeValueRequest request = new GetWorksheetCellsRangeValueRequest();
request.setName(remoteName);
request.setSheetName("Sheet1");
request.setNamerange("");
request.setFirstRow(0);
request.setFirstColumn(0);
request.setRowCount(3);
request.setColumnCount(2);
request.setFolder(remoteFolder);
request.setStorageName("");
RangeValueResponse response = api.getWorksheetCellsRangeValue(request);
} catch (ApiException e) {
e.printStackTrace();
}catch (IOException e) {
e.printStackTrace();
}
}
}
PHP
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
<?php
# For complete examples and data files, please go to https://github.com/aspose-cells-cloud/aspose-cells-cloud-php
require_once('vendor\autoload.php');
use \Aspose\Cells\Cloud\Api\CellsApi;
use \Aspose\Cells\Cloud\Request\PostSetCellRangeValueRequest;
class Cell {
public $instance;
public function __construct() {
$this->instance = new CellsApi(getenv("CellsCloudClientId"),getenv("CellsCloudClientSecret"),"v3.0",getenv("CellsCloudApiBaseUrl"));
}
public function postSetCellRangeValue() {
$remoteFolder = "TestData/In";
$localName = "Book1.xlsx";
$remoteName = "Book1.xlsx";
$request = new PostSetCellRangeValueRequest();
$request->setName( $remoteName);
$request->setSheetName( "Sheet1");
$request->setCellarea( "A1:C10");
$request->setValue( "Test");
$request->setType( "string");
$request->setFolder( $remoteFolder);
$request->setStorageName( "");
$this->instance->postSetCellRangeValue($request);
}
}
$instance = new Cell();
$instance->postSetCellRangeValue();
?>
Ruby
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
# For complete examples and data files, please go to https://github.com/aspose-cells-cloud/aspose-cells-cloud-ruby
require 'aspose_cells_cloud'
class Cell
include AsposeCellsCloud
def initialize
#Get client_id and client_secret from https://cloud.aspose.com
@instance = AsposeCellsCloud::CellsApi.new($client_id,$client_secret,$api_version,$baseurl)
end
# Set cell range value
def set_cell_range_value
name = $BOOK1
sheet_name = $SHEET1
cellarea = $CELLAREA
value = 1
type = 'string'
folder = $TEMPFOLDER
storage = nil
result = @instance.upload_file( folder+"/"+name, ::File.open(File.expand_path("data/"+name),"r") {|io| io.read(io.size) })
expect(result.uploaded.size).to be > 0
result = @instance.cells_post_set_cell_range_value(name, sheet_name, cellarea, value, type, { :folder=>folder})
expect(result.code).to eql(200)
end
end
cell = Cell.new()
puts cell.set_cell_range_value
Node.js
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
const { CellsApi, UploadFileRequest, Cells_PostSetCellRangeValueRequest } = require("asposecellscloud");
const clientId = process.env.CellsCloudClientId;
const clientSecret = process.env.CellsCloudClientSecret;
const ApiURL = process.env.CellsCloudApiBaseUrl;
const fs = require('fs');
const path = require('path');
const cellsApi = new CellsApi(clientId, clientSecret,"v3.0",ApiURL);
const localPath = "D:/aspose-cells-cloud-node/TestData/"
const filename = "Book1.xlsx";
const data =fs.createReadStream(path.join(localPath, filename));
const req = new UploadFileRequest({
path: "Temp/" + filename,
file: data
});
cellsApi.uploadFile(req)
.then((result) => {
const req = new Cells_PostSetCellRangeValueRequest();
req.name = filename;
req.sheetName = "Sheet1";
req.cellarea = "A1:C10";
req.folder = "Temp";
req.value = "1";
req.type = "int";
cellsApi.cellsPostSetCellRangeValue(req)
.then((result) => {
req.value = "12345";
req.type = "String";
cellsApi.cellsPostSetCellRangeValue(req)
.then((result) => {
req.value = "2017-10-1";
req.type = "DateTime";
cellsApi.cellsPostSetCellRangeValue(req)
.then((result) => {
console.log("cellsPostSetCellRangeValue test done.")
})
})
})
})
Python
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
# For complete examples and data files, please go to https://github.com/aspose-cells-cloud/aspose-cells-cloud-python
import os
from asposecellscloud.apis.cells_api import CellsApi
from asposecellscloud.models import *
from asposecellscloud.requests import *
CellsCloudClientId ='....' # get from https://dashboard.aspose.cloud/#/applications
CellsCloudClientSecret='....' # get from https://dashboard.aspose.cloud/#/applications
api = CellsApi(CellsCloudClientId,CellsCloudClientSecret)
request = PostSetCellRangeValueRequest( 'Book1.xlsx', 'Sheet1', 'A1:C10', 'Test', 'string',folder= 'PythonTest',storage_name= '')
api.post_set_cell_range_value(request)
Swift
Perl
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
# For complete examples and data files, please go to https://github.com/aspose-cells-cloud/aspose-cells-cloud-perl/
use strict;
use warnings;
use utf8;
use File::Slurp;
use MIME::Base64;
use AsposeCellsCloud::CellsApi;
my $config = AsposeCellsCloud::Configuration->new( client_id => $ENV{'ProductClientId'}, client_secret => $ENV{'ProductClientSecret'});
my $instance = AsposeCellsCloud::CellsApi->new(AsposeCellsCloud::ApiClient->new( $config));
my $remoteFolder = 'TestData/In';
my $remoteName = 'Book1.xlsx';
my $request = AsposeCellsCloud::Request::PostWorksheetCellSetValueRequest->new();
$request->{name} = $remoteName;
$request->{sheet_name} = 'Sheet1';
$request->{cell_name} = 'A1';
$request->{value} = '1';
$request->{type} = 'int';
$request->{folder} = $remoteFolder;
$request->{storage_name} = '';
my $result = $api->post_worksheet_cell_set_value(request=> $request);
Go