UserGuide_Developers.ja - OpenTouryoProject/OpenTouryo GitHub Wiki
2026幎7ææŽæ°ç
- Open æ£æ¢ãçšããã¢ããªã±ãŒã·ã§ã³éçºãè¡ããSEã»éçºè
æ¬ããã¥ã¡ã³ãã¯ãéçºè ãææ¡ããŠããã¹ãç¹ã«ã€ããŠçºããŠããŸããéçºè ãšã¯ã(ãµãã¯ã©ã¹ãªã©ã«) ããããã®æ¥ååŠçãå®è£ ããã¿ã¹ã¯ãæ ãè ãæããŸãã
æ¬ããã¥ã¡ã³ãã«èšèŒã®äŒç€Ÿåã»åååã¯ãå瀟ã®åæšãŸãã¯ç»é²åæšã§ãã
å³äžã®å¡äŸïŒ
- èµ€æ ïŒå®è£ å¿ é ã®ã³ãŒããããã¯
- èµ€æ (ç Žç·)ïŒå®è£ ã«æ³šæãå¿ èŠãªã³ãŒããããã¯
- éæåïŒä»»æã®å®è£ ãå¯èœãªã³ãŒããããã¯
â» åå³ã®å 容ã¯ãå³ã®äžã«ã³ãŒããšããŠäœµèšããŠããŸãïŒå³ã衚瀺ãããªãå Žåãã³ãŒããåç §ã§ããŸãïŒã
1. ãåŒæ°ã¯ã©ã¹ãã»ãæ»ãå€ã¯ã©ã¹ãã®æºå
2. Bå±€ãã¬ãŒã ã¯ãŒã¯ã®å©ç𿹿³
- 2.1 ãæ¥åã³ãŒã ã¯ã©ã¹ããäœæãã
- 2.2 ãæ¥åã³ãŒã ã¯ã©ã¹ãã«ã¡ãœãããå®è£ ãã
3. Då±€ãã¬ãŒã ã¯ãŒã¯ã®å©ç𿹿³
- 3.1 ãããŒã¿ã¢ã¯ã»ã¹ ã¯ã©ã¹ããäœæãã
- 3.2 ãããŒã¿ã¢ã¯ã»ã¹ ã¯ã©ã¹ãã«ã¡ãœãããå®è£ ãã
- 3.3 SQL ã®äœæ
4. På±€ãã¬ãŒã ã¯ãŒã¯ã®å©ç𿹿³
- 4.1 ãã³ã³ãã³ã ããŒãžïŒç»é¢ã³ãŒã ã¯ã©ã¹ïŒããäœæãã
- 4.2 ãæ¥åã³ãŒã ã¯ã©ã¹ãã®ã¡ãœãããåŒã³åºã
Dã»B å±€ãå®è£ ããåã«ãå®è£ ã®éã«å¿ èŠãšãªããåŒæ°ã¯ã©ã¹ãã»ãæ»ãå€ã¯ã©ã¹ããäœæããŸãã
- ãåŒæ°ã¯ã©ã¹ãã»ãæ»ãå€ã¯ã©ã¹ãã¯ãå¿ èŠã«å¿ããŠäœæããã
- ã¯ã©ã¹åç§°ã¯ä»»æã®åç§°ã«å€æŽå¯èœã§ããã
以äžã«å®è£ ã®ãã³ãã¬ãŒãã瀺ããŸãããµã³ãã« ããã°ã©ã ã«ä»å±ã®ãTestParameterValueãã»ãTestReturnValueãã¯ã©ã¹ã®å®è£ ãåèã«ã§ããŸãã
using ProjectName.Infrastructure.Business.Common;
public class TestParameterValue : MyParameterValue // ãåŒæ°èŠªã¯ã©ã¹ïŒããç¶æ¿ãã
{
// ãåŒæ°ã¯ã©ã¹ãã«å¿
èŠãªèŠçŽ ã远å å®çŸ©ãã
public int ShipperID;
public string CompanyName;
public string Phone;
#region ã³ã³ã¹ãã©ã¯ã¿
public TestParameterValue(string screenId, string controlId, string methodName, string actionType)
: base(screenId, controlId, methodName, actionType)
{
// Base ã®ã³ã³ã¹ãã©ã¯ã¿ã«åŒæ°ãæž¡ãããã«å¿
èŠã
}
#endregion
}å³ 1-1ããåŒæ°ã¯ã©ã¹ãã®å®è£ ã®ãã³ãã¬ãŒã
using ProjectName.Infrastructure.Business.Common;
public class TestReturnValue : MyReturnValue // ãæ»ãå€èŠªã¯ã©ã¹ïŒããç¶æ¿ãã
{
// ãæ»ãå€ã¯ã©ã¹ãã«å¿
èŠãªèŠçŽ ã远å å®çŸ©ãã
public object Obj;
public int ShipperID;
public string CompanyName;
public string Phone;
}å³ 1-2ããæ»ãå€ã¯ã©ã¹ãã®å®è£ ã®ãã³ãã¬ãŒã
ãæ¥åã³ãŒã ã¯ã©ã¹ãã«ã¯ãæ¥ååŠçãå®è£ ããŸãã
- ãæ¥åã³ãŒã ã¯ã©ã¹ãã¯ãå¿ èŠã«å¿ããŠäœæããã
- ãMyFcBaseLogicãã¯ã©ã¹ãç¶æ¿ããã
- ã¯ã©ã¹åç§°ã¯ä»»æã®åç§°ã«å€æŽå¯èœã§ããã
以äžã«å®è£ ã®ãã³ãã¬ãŒãã瀺ããŸãïŒãµã³ãã«ã®ãLayerBãã¯ã©ã¹ãåèã«ã§ããŸãïŒã
#region using
// Systemïœ
using System;
ïœ
using ProjectName.Infrastructure.Business.Business;
#endregion
/// <summary>
/// LayerB ã®æŠèŠã®èª¬æã§ã
/// </summary>
public class LayerB : MyFcBaseLogic // ãæ¥åã³ãŒã芪ã¯ã©ã¹ïŒããç¶æ¿ãã
{
}å³ 2.1ããæ¥åã³ãŒã ã¯ã©ã¹ãã®å®è£ ã®ãã³ãã¬ãŒã
ãæ¥åã³ãŒã ã¯ã©ã¹ãã«ãæ¥ååŠçããå®è£ ããå Žåããæ¥åã³ãŒã芪ã¯ã©ã¹ïŒãã®ãUOC_DoActionãã¡ãœããã«ãæ¥ååŠçã¡ãœããã®èªåæ¯ãåãåŠçããå®è£ ãããŠããããããã®æ¯ãåãåŠçã«åŸãããæ¥åã³ãŒã ã¯ã©ã¹ãã« UOC ã¡ãœããã远å ããŠãæ¥ååŠçããå®è£ ããŸãã
æ¯ãåãåŠçã§ã¯ããåŒæ°èŠªã¯ã©ã¹ïŒãã®ãã©ã¡ã¿ã«ãããmethodNameãããããã£ã䜿çšããŠã¡ãœããåãçæããã¬ã€ããã€ã³ãã«ããåŠçãæ¯ãåããŸãããæ¯ãåãããžãã¯ãã®ã«ã¹ã¿ãã€ãºã¯èªç±ã§ãããããã©ã«ãã§ã¯ãUOC_(methodName ã«æå®ãããæåå)ãã¡ãœãããã¬ã€ããã€ã³ãã«ããåŒã³åºãããŸãã
/// <summary>btnButton1 ã«å¯Ÿå¿ããæ¥ååŠçãå®è£
</summary>
/// <param name="parameterValue">åŒæ°ã¯ã©ã¹</param>
private void UOC_ïŒïŸïœ¿ïœ¯ïŸïŸåïŒ(XParameterValue xParameter)
{
// æ»ãå€ã¯ã©ã¹ãçæ
XReturnValue xReturn = new XReturnValue();
// æ»ãå€èšå®
this.ReturnValue = xReturn;
// âæ¥ååŠç-----------------------------------------------------
// ããŒã¿ã¢ã¯ã»ã¹ ã¯ã©ã¹ãçæãã
LayerD myDao = new LayerD(this.GetDam());
myDao.xxxx(xParameter, xReturn);
// âæ¥ååŠç-----------------------------------------------------
}å³ 2.2ããæ¥åã³ãŒã ã¯ã©ã¹ãã®ãæ¥ååŠçã¡ãœãããã®å®è£ äŸ
- åŒæ°ã¯ã©ã¹ã¯ãæ¥åæ¯ã®åãšããŠã¡ãœããåŒæ°ã«å®çŸ©ã§ãã (ããŒã¹ã¯ã©ã¹ã®åã§å®çŸ©ããå¿ èŠããªã) ã®ã§ããã£ã¹ãã¯äžèŠã§ãã
- ããŒã¿ã¢ã¯ã»ã¹ã®ãããããŒã¿ã¢ã¯ã»ã¹ ã¯ã©ã¹ããçæããŸã (äœææ¹æ³ã¯æ¬¡ç« ãåç §)ã
- ãæ¥ååŠçãã®æ»ãå€ãæ»ãå Žåã
this.ReturnValueã¡ã³ã倿°ã䜿çšããŠæ»ãå¿ èŠããããŸã (ããã«ãããäŸå€çºçæã«ãæ»ãå€ãæ»ããŸã)ãã¡ãœããã®å é ã§ã¡ã³ã倿°ã«ããŒã«ã«å€æ°ã®åç §ãèšå®ããŠãããšè¯ãã§ãããã - ãã©ã³ã¶ã¯ã·ã§ã³ãããŒã«ããã¯ããå Žåã¯ããæ¥ååŠçãå éšã§ãæ¥åäŸå€ããã¹ããŒããŸãããã·ã¹ãã äŸå€ããã¹ããŒããå Žåãããã®ä»ãäžè¬çãªäŸå€ããçºçããå ŽåãããŒã«ããã¯ãããŸãããã以å€ã®å Žå (B å±€ãæ£åžžçµäºããå Žå) ã¯ããã©ã³ã¶ã¯ã·ã§ã³ã¯å šãŠã³ããããããŸãã
ãããŒã¿ã¢ã¯ã»ã¹ ã¯ã©ã¹ãã«ã¯ãæ¥åã®ããŒã¿ã¢ã¯ã»ã¹åŠçãå®è£ ããŸãã
- ãããŒã¿ã¢ã¯ã»ã¹ ã¯ã©ã¹ãã¯ãå¿ èŠã«å¿ããŠäœæããã
- ã¯ã©ã¹åç§°ã¯ä»»æã®åç§°ã«å€æŽå¯èœã§ããã
以äžã«å®è£ ã®ãã³ãã¬ãŒãã瀺ããŸãïŒãµã³ãã«ã®ãLayerDãã¯ã©ã¹ãåèã«ã§ããŸãïŒã
#region using
// å¿
èŠãªåå空éãã€ã³ããŒãããã
// Systemïœ
using System;
ïœ
using ProjectName.Infrastructure.Public.Util;
#endregion
/// <summary>
/// LayerD ã®æŠèŠã®èª¬æã§ã
/// </summary>
public class LayerD : MyBaseDao // ãããŒã¿ã¢ã¯ã»ã¹èŠªã¯ã©ã¹ïŒããç¶æ¿ãã
{
/// <summary>ã³ã³ã¹ãã©ã¯ã¿</summary>
public LayerD(BaseDam dam) : base(dam)
{
// åºæ¬çã«ã¯äœãå®è£
ããªã
}
}å³ 3.1ããããŒã¿ã¢ã¯ã»ã¹ ã¯ã©ã¹ãã®å®è£ ã®ãã³ãã¬ãŒã
B å±€äžã§ D å±€ãçæããå Žåãã³ã³ã¹ãã©ã¯ã¿ã«ãããŒã¿ã¢ã¯ã»ã¹å¶åŸ¡ã¯ã©ã¹ããèšå®ããŸããD å±€ã¯ããã®ãããŒã¿ã¢ã¯ã»ã¹å¶åŸ¡ã¯ã©ã¹ããä¿æããããŒã¿ã¢ã¯ã»ã¹ã®éã«äœ¿çšããŸãã
ãããŒã¿ã¢ã¯ã»ã¹ ã¯ã©ã¹ãã«ãããŒã¿ã¢ã¯ã»ã¹åŠçããå®è£ ããå Žåã¯ã以äžã®ãã³ãã¬ãŒããå©çšããŠã¡ãœãããå®è£ ããŸã (ã¡ãœããã®ã·ã°ããã£ã¯ãäžèšã®ãã³ãã¬ãŒãã«åŸã£ãå®çŸ©ã«ããå¿ èŠã¯ãããŸãã)ã
#region ãã³ãã¬
public void ãã³ãã¬(TestParameterValue testParameter, TestReturnValue testReturn)
{
// âDBã¢ã¯ã»ã¹-----------------------------------------------------
// â äžèšã®ãã¥ããã®æ¹æ³ã§ SQL ãèšå®ããã
// -- ãã¡ã€ã«ããèªã¿èŸŒãå Žåã
this.SetSqlByFile2("ãã¡ã€ã«å");
// -- çŽæ¥æå®ããå Žåã
this.SetSqlByCommand("SQLæ");
// â äžèšã®æ¹æ³ã§ SQL ã«ãã©ã¡ã¿ãèšå®ããã
// ãã©ã¡ã¿ã©ã€ãºãã»ã¯ãšãªã®ãã©ã¡ã¿ã«å¯ŸããŠãåçã«å€ãèšå®ããã
this.SetParameter("P1", testParameter.ShipperID);
// ãŠãŒã¶å®çŸ©ãã©ã¡ã¿ã眮æããïŒ%% ã¯æå®ããªãïŒã
this.SetUserParameter("SEQUENCE", "DESC");
// â äžèšã®ãã¥ããã®æ¹æ³ã§ SQL ãå®è¡ããã
object obj;
// -- 远å ãæŽæ°ãåé€ã®å ŽåïŒä»¶æ°ã確èªã§ããïŒ
obj = this.ExecInsUpDel_NonQuery();
// -- å
é ã®ïŒã»ã«åã®æ
å ±ãè¿ã SELECT ã¯ãšãªãå®è¡ããå Žå
obj = this.ExecSelectScalar();
// -- ããŒãã«ïŒor ã¬ã³ãŒãïŒã®æ
å ±ãè¿ã SELECT ã¯ãšãªãå®è¡ããå ŽåïŒåŒæ° = ããŒã¿ããŒãã«ïŒ
obj = new DataTable();
this.ExecSelectFill_DT((DataTable)obj);
// -- ããŒãã«ïŒor ã¬ã³ãŒãïŒã®æ
å ±ãè¿ã SELECT ã¯ãšãªãå®è¡ããå ŽåïŒåŒæ° = ããŒã¿ã»ããïŒ
obj = new DataSet();
this.ExecSelectFill_DS((DataSet)obj);
// -- ããŒã¿ãªãŒããè¿ã
IDataReader idr = (IDataReader)this.ExecSelect_DR();
// âDBã¢ã¯ã»ã¹-----------------------------------------------------
// æ»ãå€ãèšå®
testReturn.Obj = obj;
}
#endregionå³ 3.2ããããŒã¿ã¢ã¯ã»ã¹ ã¯ã©ã¹ãã®ãããŒã¿ã¢ã¯ã»ã¹åŠçãã®å®è£ äŸ
æ¬ãã¬ãŒã ã¯ãŒã¯ã§ã¯ãSQL æã®æå®æ¹æ³ãã以äžã® 2 ã€ã®æ¹æ³ããéžæã§ããŸãã
- ãã¡ã€ã«ããèªã¿èŸŒãæ¹æ³
- ããã°ã©ã äžã®ãªãã©ã« (æåå宿°) ã䜿çšããŠçŽæ¥æå®ããæ¹æ³
SQL ã®æå®æ¹æ³ã«ãã£ãŠã䜿çšãã API ã䜿ãåããŸãã
-
ãã¡ã€ã«ããèªã¿èŸŒãå ŽåïŒ
GetConfigParameter.GetConfigValueã¡ãœããã§ SQL ãã¡ã€ã«ã®ä¿åãã©ã«ããååŸããPath.Combineã§ SQL ãã¡ã€ã«åãé£çµããŠãSetSqlByFileã¡ãœããã®ãã¹åŒæ°ãšããŠæž¡ããŸããææ°çã§ã¯SetSqlByFile2ã¡ãœããã®å©çšãæšå¥šããŸã (å éšã§ sqlTextFilePath ãã©ã¡ã¿ãšã®é£çµãåã蟌ã¿ãªãœãŒã¹ããã®èªã¿èŸŒã¿ããµããŒã)ã
// -- ãã¡ã€ã«ããèªã¿èŸŒãå Žåã
this.SetSqlByFile(
Path.Combine(GetConfigParameter.GetConfigValue("sqlTextFilePath"), "ãã¡ã€ã«å"));// -- ãã¡ã€ã«ãåã蟌ãŸãããªãœãŒã¹ããèªã¿èŸŒãå Žåã
// åã蟌ãŸãããªãœãŒã¹ããèªã¿èŸŒãå Žåãæ¬¡ã®èšå®ãå¿
èŠã«ãªãã
// MyBaseDao.UseEmbeddedResource = true;
this.SetSqlByFile2("ãã¡ã€ã«å");å³ 3.3.1-1ãSQL ããã¡ã€ã«ããèªã¿èŸŒãå Žå
-
çŽæ¥æå®ããå ŽåïŒ
SetSqlByCommandã¡ãœããã® SQL åŒæ°ã« SQL æã®æååãªãã©ã«ãæå®ããŸãã
// -- çŽæ¥æå®ããå Žåã
this.SetSqlByCommand("SQLæ");å³ 3.3.1-2ãSQL ãçŽæ¥æå®ããå Žå
SQL ã«ãŠãŒã¶å®çŸ©ãã©ã¡ã¿ãå®çŸ©ããAPI ã䜿çšããŠããã°ã©ã ãã眮æã§ããŸãã以äžãåçã« SQL ãçæããäŸã瀺ããŸãã
- SQL ã«ãŠãŒã¶å®çŸ©ãã©ã¡ã¿ãå®çŸ©ãã (ãŠãŒã¶å®çŸ©ãã©ã¡ã¿ã¯
%ã§å²ã)ã
SELECT c1, c2, c3 FROM t1 %Where% ORDER BY %COLUMN% %SEQUENCE%å³ 3.3.2-1 SQL ã«ãŠãŒã¶å®çŸ©ãã©ã¡ã¿ãå®çŸ©ããå Žå
-
SetSqlByCommandã¡ãœããããŸãã¯SetSqlByFile(SetSqlByFile2)ã¡ãœããã䜿çšã㊠SQL ãæå®ããã -
SetUserParameterã¡ãœããã䜿çšããŠããŠãŒã¶å®çŸ©ãã©ã¡ã¿ã眮æããã
- %Where% âïŒçœ®æïŒâ WHERE c4 = @p_c4, c5 = @p_c5
- %COLUMN% âïŒçœ®æïŒâ c2
- %SEQUENCE% âïŒçœ®æïŒâ DESC
// ãŠãŒã¶å®çŸ©ãã©ã¡ã¿ã眮æããïŒ%% ã¯æå®ããªãïŒã
this.SetUserParameter("SEQUENCE", "DESC");å³ 3.3.2-2 ãŠãŒã¶å®çŸ©ãã©ã¡ã¿ã眮æããå Žå
- 宿ãã SQL (ãã©ã¡ã¿ã©ã€ãºãã»ã¯ãšãª)ã
SELECT c1, c2, c3 FROM t1 WHERE c4 = @p_c4, c5 = @p_c5 ORDER BY c2 DESCå³ 3.3.2-3 宿ãã SQL (ãã©ã¡ã¿ã©ã€ãºãã»ã¯ãšãª)
- ãã®ãã©ã¡ã¿ã©ã€ãºãã»ã¯ãšãªã®ãã©ã¡ã¿ãèšå®ã㊠SQL ãå®è¡ãã (次é ã§èª¬æ)ã
â» ãŠãŒã¶å®çŸ©ãã©ã¡ã¿ã¯ãSQL ã€ã³ãžã§ã¯ã·ã§ã³å¯Ÿçããããªãããã眮æçšæåå倿°ã®ãã§ãã¯ãããã°ã©ã åŽã§è¡ããããŠãŒã¶å ¥åãçŽæ¥ã眮æçšæåå倿°ãšããŠæå®ããªãããã«ããŸããåºæ¬çã«ããŠãŒã¶å ¥åã¯ãã©ã¡ã¿ã©ã€ãºãã»ã¯ãšãªã®ãã©ã¡ã¿ãšããŠæå®ããŸãã
SQL ã¯ãSQL ã€ã³ãžã§ã¯ã·ã§ã³å¯Ÿçããæ¡ä»¶æ€çŽ¢ãªã©ã®åç SQL ã«ãããã¯ãšãª ãã©ã³ã®åå©çšãªã©ã®èгç¹ããããã©ã¡ã¿ã©ã€ãºãã»ã¯ãšãªã䜿çšããã®ãããã¡ã¯ã ã¹ã¿ã³ããŒãã§ãããã©ã¡ã¿ã©ã€ãºãã»ã¯ãšãªã®å®çŸ©æ¹æ³ã¯ DBMS æ¯ã«ç°ãªãã®ã§æ³šæããŸãã
- SQL Server ã§ã¯ãã©ã¡ã¿ãã@ ïŒãã©ã¡ã¿åãã§å®çŸ©ããã
- Oracle ã§ã¯ãã©ã¡ã¿ãã: ïŒãã©ã¡ã¿åãã§å®çŸ©ããã
衚 3.3.3ãSQL Server ãš Oracle ã®ãã©ã¡ã¿ã©ã€ãºãã»ã¯ãšãªã®äŸ
| é çª | åºå | SQL Server ã®äŸ | Oracle ã®äŸ |
|---|---|---|---|
| ïŒ | INSERT | INSERT INTO Shippers (CompanyName, Phone) VALUES (@P2, @P3) |
INSERT INTO Shippers (CompanyName, Phone) VALUES (:P2, :P3) |
| ïŒ | UPDATE | UPDATE Shippers SET CompanyName = @P2, Phone = @P3 WHERE ShipperID = @P1 |
UPDATE Shippers SET CompanyName = :P2, Phone = :P3 WHERE ShipperID = :P1 |
| ïŒ | DELETE | DELETE Shippers WHERE ShipperID = @P1 |
DELETE Shippers WHERE ShipperID = :P1 |
| ïŒ | SELECT | SELECT ShipperID, CompanyName, Phone FROM Shippers WHERE ShipperID = @P1 |
SELECT ShipperID, CompanyName, Phone FROM Shippers WHERE ShipperID = :P1 |
ãã©ã¡ã¿ã©ã€ãºãã»ã¯ãšãªã®ãã©ã¡ã¿ã«å¯ŸããŠå€ãèšå®ããã«ã¯ãSetParameter ã¡ãœããã䜿çšããŸãããªãŒããŒããŒãããã¡ãœããã§ã¯ãåããŒã¿ãããã€ãã®ããŒã¿å ,etc. ã®æå®ãå¯èœã§ãã
// ãã©ã¡ã¿ã©ã€ãºãã»ã¯ãšãªã®ãã©ã¡ã¿ã«å¯ŸããŠãåçã«å€ãèšå®ããã
this.SetParameter("P1", testParameter.ShipperID);å³ 3.3.4ããã©ã¡ã¿ã©ã€ãºãã»ã¯ãšãªã®ãã©ã¡ã¿æå®ã¡ãœãã
SQL ã®å®è¡ã«ã¯ã以äžã® 5 ã€ã®ã¡ãœãããå©çšã§ããŸãã
// -- 远å ãæŽæ°ãåé€ã®å ŽåïŒä»¶æ°ã確èªã§ããïŒ
obj = this.ExecInsUpDel_NonQuery();
// -- ïŒã»ã«åã®æ
å ±ãè¿ã SELECT ã¯ãšãªãå®è¡ããå Žå
obj = this.ExecSelectScalar();
// -- ããŒãã«ïŒor ã¬ã³ãŒãïŒã®æ
å ±ãè¿ã SELECT ã¯ãšãªïŒåŒæ° = ããŒã¿ããŒãã«ïŒ
obj = new DataTable();
this.ExecSelectFill_DT((DataTable)obj);
// -- ããŒãã«ïŒor ã¬ã³ãŒãïŒã®æ
å ±ãè¿ã SELECT ã¯ãšãªïŒåŒæ° = ããŒã¿ã»ããïŒ
obj = new DataSet();
this.ExecSelectFill_DS((DataSet)obj);
// -- ããŒã¿ãªãŒããè¿ã
IDataReader idr = (IDataReader)this.ExecSelect_DR();å³ 3.3.5ãSQL ã®å®è¡ã«äœ¿çšãã 5 ã€ã®ã¡ãœãã
衚 3.3.5ãåã¡ãœãããšãå®è¡ãã SQLã»æ»ãå€ã®é¢ä¿
| é çª | åºå | å©çšå¯èœãªã¡ãœãã | æ»ãå€ |
|---|---|---|---|
| ïŒ | INSERT | ExecInsUpDel_NonQuery() | 圱é¿ãåãã (远å ããã) è¡ã®è¡æ°ãè¿ãã |
| ïŒ | UPDATE | ExecInsUpDel_NonQuery() | 圱é¿ãåãã (æŽæ°ããã) è¡ã®è¡æ°ãè¿ãã |
| ïŒ | DELETE | ExecInsUpDel_NonQuery() | 圱é¿ãåãã (åé€ããã) è¡ã®è¡æ°ãè¿ãã |
| ïŒ | SELECT | ExecSelectScalar() | çµæã»ããã®ãå é ã® 1 ã»ã«åã®æ å ±ãè¿ãã |
| ïŒ | SELECT | ExecSelectFill_DT() | çµæã»ãã (ããŒã¿ ããŒãã«å) ãè¿ããâ» ããŒã¿ ããŒãã«åã®åŒæ°ãæž¡ãã |
| ïŒ | SELECT | ExecSelectFill_DS() | çµæã»ãã (ããŒã¿ ããŒãã«å) ãè¿ããâ» ããŒã¿ ã»ããåã®åŒæ°ãæž¡ãã |
| ïŒ | SELECT | ExecSelect_DR() | ããŒã¿ãªãŒããè¿ãã |
ãã³ã³ãã³ã ããŒãžïŒç»é¢ã³ãŒã ã¯ã©ã¹ïŒãã«ã¯ãP å±€ã®ã€ãã³ãåŠçãå®è£ ããŸãã
- ãã³ã³ãã³ã ããŒãžïŒç»é¢ã³ãŒã ã¯ã©ã¹ïŒãã¯ãå¿ èŠã«å¿ããŠäœæããã
- ã¯ã©ã¹åç§°ã¯ä»»æã®åç§°ã«å€æŽå¯èœã§ããã
ãœãªã¥ãŒã·ã§ã³ ãšã¯ã¹ãããŒã©äžã®ä»»æã®äœçœ®ã§å³ã¯ãªãã¯ã [æ°ããé ç®ã®è¿œå ] ãéžæãããšã[æ°ããé ç®ã®è¿œå ] ãã€ã¢ãã°ã衚瀺ãããŸãããã³ãã¬ãŒããããWeb ãã©ãŒã ããéžæãã[ãã¹ã¿ ããŒãžãéžæãã] ãã§ã㯠ããã¯ã¹ããªã³ã«ããŠãã³ã³ãã³ã ããŒãžãäœæããŸãã
å³ 4.1.1-1ã[æ°ããé ç®ã®è¿œå ] ãã€ã¢ãã°
ãããš [ãã¹ã¿ ããŒãžãéžæããŠãã ãã] ãã€ã¢ãã°ã衚瀺ãããã®ã§ããã³ã³ãã³ã ããŒãžïŒç»é¢ã³ãŒã ã¯ã©ã¹ïŒãã§äœ¿çšããããã¹ã¿ ããŒãžããéžæããŸãã
å³ 4.1.1-2ã[ãã¹ã¿ ããŒãžãéžæããŠãã ãã] ãã€ã¢ãã°
äžèšã®æäœã§ãæ¬¡ã®æ§ãªã³ã³ãã³ã ããŒãžãäœæãããŸãã
<%@ Page Language="C#" MasterPageFile="~/Aspx/Common/TestScreen.master" AutoEventWireup="true"
CodeFile="testScreen.aspx.cs" Inherits="Aspx_testFxLayerP_testScreen" Title="Untitled Page" %>
<asp:Content ID="Content1" ContentPlaceHolderID="ContentPlaceHolder1" Runat="Server">
</asp:Content>å³ 4.1.1-3ãäœæãããã³ã³ãã³ã ããŒãž
â» éžæãããã¹ã¿ ããŒãžã®æ§æã«åãããŠãã³ã³ãã³ã ããŒãžäžã« ContentPlaceHolder ãèªåçæãããŸããContentPlaceHolder å ã®å®è£ ã¯ãŠãŒã¶ãèªç±ã«å€æŽã§ããŸãã
ãã³ã³ãã³ã ããŒãžãã®äœæã»ãã¶ã€ã³ã®å®äºåŸãã³ãŒã ããã€ã³ãã§ãããç»é¢ã³ãŒã ã¯ã©ã¹ãã«åŠçãå®è£ ããŸãã以äžã«å®è£ ã®ãã³ãã¬ãŒãã瀺ããŸãã
// å¿
èŠãªåå空éãã€ã³ããŒãããã
// Systemïœ
using System;
ïœ
using ProjectName.Infrastructure.Business.Util;
public partial class Aspx_testFxLayerP_testScreen : MyBaseController // ãç»é¢ã³ãŒã芪ã¯ã©ã¹ïŒããç¶æ¿ãã
{
}å³ 4.1.1-4ããç»é¢ã³ãŒã ã¯ã©ã¹ãã®å®è£ ã®ãã³ãã¬ãŒã
ãããŒãž ããŒãåŠçãã¯å®è£ å¿ é ã®åŠçã§ãããUOC_FormInitãããUOC_FormInit_PostBackãã¡ãœããããç»é¢ã³ãŒã ã¯ã©ã¹ãã§ãªãŒããŒã©ã€ãããååããŒãæã»ãã¹ãããã¯æãåºå¥ããŠå®è£ ã§ããŸãã
#region ããŒãžããŒãã®UOCã¡ãœãã
/// <summary>ããŒãžããŒãã®UOCã¡ãœããïŒåå¥ïŒååããŒãïŒ</summary>
/// <remarks>å®è£
å¿
é </remarks>
protected override void UOC_FormInit()
{
// ãã©ãŒã åæåïŒååããŒãïŒæã«å®è¡ããåŠçãå®è£
ãã
// TODO:
}
/// <summary>ããŒãžããŒãã®UOCã¡ãœããïŒåå¥ïŒãã¹ãããã¯ïŒ</summary>
/// <remarks>å®è£
å¿
é </remarks>
protected override void UOC_FormInit_PostBack()
{
// ãã©ãŒã åæåïŒãã¹ãããã¯ïŒæã«å®è¡ããåŠçãå®è£
ãã
// TODO:
}
#endregionå³ 4.1.2ããããŒãž ããŒãåŠçãã®å®è£ äŸ
以äžã®æé ã«åŸããŸãã
- ããã¹ã¿ ããŒãžãäžã«ã³ã³ãããŒã« ([prefix] ä»»æã®æåå) ãé 眮ããã
- ãç»é¢ã³ãŒã ã¯ã©ã¹ãäžã« UOC ã¡ãœãã
UOC_ïŒãã¹ã¿ ããŒãž ãã¡ã€ã«åïŒ_[prefix]ä»»æã®æåå_Clickãå®è£ ããã
- ããã¹ã¿ ããŒãžãäžïŒãã¿ã³ã®ã«ã¹ã¿ã ã³ã³ãããŒã«ãéžæããå Žåã®äŸïŒ
<cc1:WebCustomButton ID="btnMasterIdvdl" runat="server" Text="ïŒãã¿ã³è¡šç€ºåïŒ" Width="220px" /><br />å³ 4.1.3-1ãããã¹ã¿ ããŒãžãã®å®è£ äŸ
-
ãç»é¢ã³ãŒã ã¯ã©ã¹ãäžïŒã€ãã³ã ãã³ãã©ã®ã·ã°ããã£ã¯
protected string ã€ãã³ã ãã³ãã©å(FxEventArgs fxEventArgs)ãšããŸã (GridView ã® RowUpdatingïŒRowDeletingïŒPageIndexChangingïŒSorting ã¯(FxEventArgs fxEventArgs, EventArgs e))ããã¹ã¿ ããŒãž ãã¡ã€ã«åïŒãTestScreen.masterãã®å ŽåïŒ
protected string UOC_TestScreen_btnMasterIdvdl_Click(FxEventArgs fxEventArgs)
{
// TODO:
// ç»é¢é·ç§»ããªããã¹ãããã¯ã®å Žåã¯ãurl ã空æååã«èšå®ãã
return "";
}å³ 4.1.3-2ããç»é¢ã³ãŒã ã¯ã©ã¹ãã®å®è£ äŸ
ã€ãã³ãåŠçãå®è£ ãã UOC ã¡ãœããã¯ãå ±éã€ãã³ããã³ãã©ããã¬ã€ããã€ã³ãã§åŒã³åºãããããããpublicãããprotectedãã§å®çŸ©ããå¿ èŠããããŸã (aspx.cs(vb) ã®ãprivateãã¯ç¹æ®ã§ã¬ã€ããã€ã³ãäžå¯èœ)ãURL ããªã¿ãŒã³ããå Žåã¯ç»é¢é·ç§»ãã空æååããªã¿ãŒã³ããå Žåã¯ç»é¢é·ç§»ãããã¹ãããã¯ã«ãªããŸãã
以äžã®æé ã«åŸããŸãã
- ã³ã³ãã³ã ããŒãžäžã«ã³ã³ãããŒã« ([prefix] ä»»æã®æåå) ãé 眮ããã
- ãç»é¢ã³ãŒã ã¯ã©ã¹ãäžã« UOC ã¡ãœãã
UOC_[prefix]ä»»æã®æåå_Clickãå®è£ ããã
- ã³ã³ãã³ã ããŒãžäžã®å®è£ äŸïŒãã¿ã³ã®ã«ã¹ã¿ã ã³ã³ãããŒã«ãéžæããå Žåã®äŸïŒ
<cc1:WebCustomButton ID="btnCntnt" runat="server" Text="ïŒãã¿ã³è¡šç€ºåïŒ" Width="220px" /><br />å³ 4.1.4-1ãã³ã³ãã³ã ããŒãžäžã®å®è£ äŸ
- ãç»é¢ã³ãŒã ã¯ã©ã¹ãäžã®å®è£ äŸïŒ
protected string UOC_btnCntnt_Click(FxEventArgs fxEventArgs)
{
// TODO:
// ç»é¢é·ç§»ããªããã¹ãããã¯ã®å Žåã¯ãurl ã空æååã«èšå®ãã
return "";
}å³ 4.1.4-2ããç»é¢ã³ãŒã ã¯ã©ã¹ãäžã®å®è£ äŸ
ã€ãã³ãåŠçãå®è£ ãã UOC ã¡ãœããã¯ãå ±éã€ãã³ããã³ãã©ããã¬ã€ããã€ã³ãã§åŒã³åºãããããããpublicãããprotectedãã§å®çŸ©ããå¿ èŠããããŸã (aspx.cs(vb) ã®ãprivateãã¯ç¹æ®ã§ã¬ã€ããã€ã³ãäžå¯èœ)ãURL ããªã¿ãŒã³ããå Žåã¯ç»é¢é·ç§»ãã空æååããªã¿ãŒã³ããå Žåã¯ç»é¢é·ç§»ãããã¹ãããã¯ã«ãªããŸãã
ãæ¥åã³ãŒã ã¯ã©ã¹ãã®ã¡ãœããåŒã³åºãåŠçã¯ãäž»ãšããŠãã³ã³ãããŒã«ã®ã€ãã³ãåŠçãäžã«å®è£ ããŸãã以äžã«åŒã³åºãåŠçã®ãµã³ãã«ã瀺ããŸãïŒãµã³ãã«ã®ãç»é¢ã³ãŒã ã¯ã©ã¹ããåèã«ã§ããŸãïŒã
/// <summary>ã€ãã³ããã³ãã©</summary>
/// <param name="fxEventArgs">ã€ãã³ããã³ãã©ã®å
±éåŒæ°</param>
/// <returns>URL</returns>
protected string UOC_ïŒä»»æã®ã€ãã³ããã³ãã©åïŒ(FxEventArgs fxEventArgs)
{
// åŒæ°ã¯ã©ã¹ãçæïŒåŒæ°å€ã®èšå®ïŒ
TestParameterValue testParameterValue
= new TestParameterValue(
this.ContentPageFileNoEx, // ç»é¢ã衚ãæåå
fxEventArgs.ButtonID, // ã€ãã³ãçºçå
ã®ã³ã³ãããŒã«ID
"ïŒä»»æã®methodNameå€ïŒ", // åŒã³åºã Bå±€ã®ã¡ãœããå
"ïŒä»»æã®actionTypeå€ïŒ", // æ¡ä»¶åå²ãªã©ã«äœ¿çšãããã©ã¡ã¿
this.UserInfo); // ãŠãŒã¶æ
å ±ïŒããŒã¹ïŒã§è¿œå ïŒ
// åé¢ã¬ãã«ã®èšå®
DbEnum.IsolationLevelEnum iso = this.SelectIsolationLevel();
// Bå±€ãçæ
LayerB myBusiness = new LayerB();
// æ¥ååŠçãå®è¡
TestReturnValue testReturnValue =
(TestReturnValue)myBusiness.DoBusinessLogic(
(BaseParameterValue)testParameterValue, iso);
// çµæè¡šç€ºããã¡ãã»ãŒãž ãšãªã¢
Label label = (Label)this.GetMasterWebControl("Label1");
label.Text = "";
if (testReturnValue.ErrorFlag == true)
{
// çµæïŒæ¥åç¶è¡å¯èœãªãšã©ãŒïŒ
label.Text = "ErrorMessageID:" + testReturnValue.ErrorMessageID + "\n";
label.Text += "ErrorMessage:" + testReturnValue.ErrorMessage + "\n";
label.Text += "ErrorInfo:" + testReturnValue.ErrorInfo + "\n";
}
else
{
// çµæïŒæ£åžžç³»ïŒ
label.Text = testReturnValue.Obj.ToString();
}
// ç»é¢é·ç§»ããªããã¹ãããã¯ã®å Žåã¯ãurl ã空æååã«èšå®ãã
return "";
}å³ 4.2ããæ¥åã³ãŒã ã¯ã©ã¹ãã®ã¡ãœããåŒã³åºãåŠç
ïŒä»¥äžïŒ