Repository.Variable.GetVariable: Difference between revisions

From ReliaWiki
Jump to navigation Jump to search
(Created page with '{{Template:APIClass|Repository Class|Repository}} {{Template:Repository.GetVariable.Cmt}} ==Syntax== *GetVariable(){{APIPrefix|As}}cVariable() == Usage Exam…')
 
No edit summary
 
(17 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Template:APIClass|Repository Class|Repository}}
{{Template:API}}{{Template:APIBreadcrumb|.[[Repository Class|Repository]]}}
{{Template:Repository.GetVariable.Cmt}}


==Syntax==
*GetVariable(){{APIPrefix|As}}[[cVariable Class|cVariable]]()


== Usage Example ==
<onlyinclude>Returns a '''[[CVariable Class|cVariable]]''' object that represents a given variable resource in the current project. Returns nothing if the variable does not exist or is not in the current project.</onlyinclude> 
<div style="margin-right: 150px;">
 
  {{APIComment|'Declare a new repository connection object.}}
== Syntax ==
  Dim MyRepository As New Repository
'''.Variable.GetVariable'''(''ID'')
 
 
  {{APIComment|'Connect to the Synthesis repository.}}
=== Parameters ===
  Dim Success As Boolean = False
''ID''
  Success = MyRepository.ConnectToRepository("RepositoryFileNamePath")
:Required. Integer. The ID number of the variable to retrieve.
 
 
  {{APIComment|'Get a variable.}}
 
  Dim GetVariable() As cVariable
== Example ==
  GetVariable= MyRepository.GetVariable()
The example assumes that a variable with ID #1 exists in the first project of a Synthesis repository.
</div>
 
'''VBA'''
  {{APIComment|'Declare a new Repository object and connect to a Synthesis repository.}}
  {{APIPrefix|Dim}} MyRepository {{APIPrefix|As New}} Repository
  MyRepository.ConnectToAccessRepository({{APIString|"C:\RSRepository1.rsr10"}})
   
  {{APIComment|'Get variable #1 from project #1.}}
  {{APIPrefix|Dim}} AVariable {{APIPrefix|As}} cVariable
  MyRepository.Project.SetCurrentProject(1)
  {{APIPrefix|Set}} AVariable = MyRepository.Variable.GetVariable(1)
{{APIComment|'Output sample: Display the name and ID of the variable.}}
  {{APIPrefix|Dim}} VariableName {{APIPrefix|As}} String
  {{APIPrefix|Dim}} VariableID {{APIPrefix|As}} Integer
  VariableName = AVariable.Name
  VariableID = AVariable.ID
  MsgBox ({{APIString|"You got "}} & VariableName & {{APIString|", ID#"}} & VariableID)
 
'''VB.NET'''
{{APIComment|'Declare a new Repository object and connect to a Synthesis repository.}}
  {{APIPrefix|Dim}} MyRepository {{APIPrefix|As New}} Repository
  MyRepository.ConnectToAccessRepository({{APIString|"C:\RSRepository1.rsr10"}})
   
  {{APIComment|'Get variable #1 from project #1.}}
  {{APIPrefix|Dim}} AVariable {{APIPrefix|As}} cVariable
  MyRepository.Project.SetCurrentProject(1)
  AVariable = MyRepository.Variable.GetVariable(1)
{{APIComment|'Output sample: Display the name and ID of the variable.}}
  {{APIPrefix|Dim}} VariableName {{APIPrefix|As}} String
  {{APIPrefix|Dim}} VariableID {{APIPrefix|As}} Integer
  VariableName = AVariable.Name
  VariableID = AVariable.ID
  MsgBox ({{APIString|"You got "}} & VariableName & {{APIString|", ID#"}} & VariableID)

Latest revision as of 18:55, 9 June 2016

APIWiki.png


Member of: SynthesisAPI.Repository


Returns a cVariable object that represents a given variable resource in the current project. Returns nothing if the variable does not exist or is not in the current project.

Syntax

.Variable.GetVariable(ID)

Parameters

ID

Required. Integer. The ID number of the variable to retrieve.


Example

The example assumes that a variable with ID #1 exists in the first project of a Synthesis repository.

VBA

 'Declare a new Repository object and connect to a Synthesis repository. 
  Dim MyRepository As New Repository
  MyRepository.ConnectToAccessRepository("C:\RSRepository1.rsr10")
   
 'Get variable #1 from project #1. 
  Dim AVariable As cVariable
  MyRepository.Project.SetCurrentProject(1)
  Set AVariable = MyRepository.Variable.GetVariable(1)

 'Output sample: Display the name and ID of the variable. 
  Dim VariableName As String
  Dim VariableID As Integer
  VariableName = AVariable.Name
  VariableID = AVariable.ID
  MsgBox ("You got " & VariableName & ", ID#" & VariableID)
VB.NET

 'Declare a new Repository object and connect to a Synthesis repository. 
  Dim MyRepository As New Repository
  MyRepository.ConnectToAccessRepository("C:\RSRepository1.rsr10")
   
 'Get variable #1 from project #1. 
  Dim AVariable As cVariable
  MyRepository.Project.SetCurrentProject(1)
  AVariable = MyRepository.Variable.GetVariable(1)

 'Output sample: Display the name and ID of the variable. 
  Dim VariableName As String
  Dim VariableID As Integer
  VariableName = AVariable.Name
  VariableID = AVariable.ID
  MsgBox ("You got " & VariableName & ", ID#" & VariableID)